--- /srv/reproducible-results/rbuild-debian/r-b-build.mRAfNT1k/b1/spooles_2.2-14.1_amd64.changes +++ /srv/reproducible-results/rbuild-debian/r-b-build.mRAfNT1k/b2/spooles_2.2-14.1_amd64.changes ├── Files │ @@ -1,5 +1,5 @@ │ │ eea99f9eff24c7731a7e009e3e8d6b2d 603892 libdevel optional libspooles-dev_2.2-14.1_amd64.deb │ c9502b97927c1ce88a91fcd52d092062 1368676 debug optional libspooles2.2t64-dbgsym_2.2-14.1_amd64.deb │ 412b29066a87c6aadbc69434cc12b9a5 472916 libs optional libspooles2.2t64_2.2-14.1_amd64.deb │ - 212d9ff9524ed4c369c01f9f0df5124d 6770644 doc optional spooles-doc_2.2-14.1_all.deb │ + c07c6e1cb85b05734d2ffada37f155a6 6752804 doc optional spooles-doc_2.2-14.1_all.deb ├── spooles-doc_2.2-14.1_all.deb │ ├── file list │ │ @@ -1,3 +1,3 @@ │ │ -rw-r--r-- 0 0 0 4 2024-02-29 17:18:08.000000 debian-binary │ │ --rw-r--r-- 0 0 0 1952 2024-02-29 17:18:08.000000 control.tar.xz │ │ --rw-r--r-- 0 0 0 6768500 2024-02-29 17:18:08.000000 data.tar.xz │ │ +-rw-r--r-- 0 0 0 1944 2024-02-29 17:18:08.000000 control.tar.xz │ │ +-rw-r--r-- 0 0 0 6750668 2024-02-29 17:18:08.000000 data.tar.xz │ ├── control.tar.xz │ │ ├── control.tar │ │ │ ├── ./control │ │ │ │ @@ -1,13 +1,13 @@ │ │ │ │ Package: spooles-doc │ │ │ │ Source: spooles │ │ │ │ Version: 2.2-14.1 │ │ │ │ Architecture: all │ │ │ │ Maintainer: Debian Science Maintainers │ │ │ │ -Installed-Size: 6866 │ │ │ │ +Installed-Size: 6847 │ │ │ │ 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 │ │ ├── xz --list │ │ │ @@ -1,13 +1,13 @@ │ │ │ Streams: 1 │ │ │ Blocks: 1 │ │ │ - Compressed size: 1952 B │ │ │ + Compressed size: 1944 B │ │ │ Uncompressed size: 10.0 KiB (10240 B) │ │ │ - Ratio: 0.191 │ │ │ + Ratio: 0.190 │ │ │ Check: CRC64 │ │ │ Stream Padding: 0 B │ │ │ Streams: │ │ │ Stream Blocks CompOffset UncompOffset CompSize UncompSize Ratio Check Padding │ │ │ - 1 1 0 0 1952 10240 0.191 CRC64 0 │ │ │ + 1 1 0 0 1944 10240 0.190 CRC64 0 │ │ │ Blocks: │ │ │ Stream Block CompOffset UncompOffset TotalSize UncompSize Ratio Check │ │ │ - 1 1 12 0 1916 10240 0.187 CRC64 │ │ │ + 1 1 12 0 1908 10240 0.186 CRC64 │ ├── data.tar.xz │ │ ├── data.tar │ │ │ ├── file list │ │ │ │ @@ -1,56 +1,56 @@ │ │ │ │ drwxr-xr-x 0 root (0) root (0) 0 2024-02-29 17:18:08.000000 ./ │ │ │ │ drwxr-xr-x 0 root (0) root (0) 0 2024-02-29 17:18:08.000000 ./usr/ │ │ │ │ drwxr-xr-x 0 root (0) root (0) 0 2024-02-29 17:18:08.000000 ./usr/share/ │ │ │ │ drwxr-xr-x 0 root (0) root (0) 0 2024-02-29 17:18:08.000000 ./usr/share/doc/ │ │ │ │ drwxr-xr-x 0 root (0) root (0) 0 2024-02-29 17:18:08.000000 ./usr/share/doc/spooles-doc/ │ │ │ │ --rw-r--r-- 0 root (0) root (0) 151375 2024-02-29 17:18:08.000000 ./usr/share/doc/spooles-doc/A2.ps.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 151062 2024-02-29 17:18:08.000000 ./usr/share/doc/spooles-doc/A2.ps.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 596035 2024-02-29 17:18:08.000000 ./usr/share/doc/spooles-doc/ASHCRAFC.ps.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 67629 2024-02-29 17:18:08.000000 ./usr/share/doc/spooles-doc/AllInOne.ps.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 127250 2024-02-29 17:18:08.000000 ./usr/share/doc/spooles-doc/BKL.ps.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 155493 2024-02-29 17:18:08.000000 ./usr/share/doc/spooles-doc/BPG.ps.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 189651 2024-02-29 17:18:08.000000 ./usr/share/doc/spooles-doc/Chv.ps.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 100358 2024-02-29 17:18:08.000000 ./usr/share/doc/spooles-doc/ChvList.ps.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 94055 2024-02-29 17:18:08.000000 ./usr/share/doc/spooles-doc/ChvManager.ps.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 120324 2024-02-29 17:18:08.000000 ./usr/share/doc/spooles-doc/Coords.ps.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 115295 2024-02-29 17:18:08.000000 ./usr/share/doc/spooles-doc/DSTree.ps.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 133413 2024-02-29 17:18:08.000000 ./usr/share/doc/spooles-doc/DV.ps.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 117117 2024-02-29 17:18:08.000000 ./usr/share/doc/spooles-doc/DenseMtx.ps.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 106985 2024-02-29 17:18:08.000000 ./usr/share/doc/spooles-doc/Drand.ps.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 120931 2024-02-29 17:18:08.000000 ./usr/share/doc/spooles-doc/EGraph.ps.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 220308 2024-02-29 17:18:08.000000 ./usr/share/doc/spooles-doc/ETree.ps.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 87701 2024-02-29 17:18:08.000000 ./usr/share/doc/spooles-doc/Eigen.ps.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 179056 2024-02-29 17:18:08.000000 ./usr/share/doc/spooles-doc/FrontMtx.ps.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 275674 2024-02-29 17:18:08.000000 ./usr/share/doc/spooles-doc/FrontTrees.ps.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 183888 2024-02-29 17:18:08.000000 ./usr/share/doc/spooles-doc/GPart.ps.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 189481 2024-02-29 17:18:08.000000 ./usr/share/doc/spooles-doc/Graph.ps.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 131500 2024-02-29 17:18:08.000000 ./usr/share/doc/spooles-doc/I2Ohash.ps.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 109292 2024-02-29 17:18:08.000000 ./usr/share/doc/spooles-doc/IIheap.ps.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 121072 2024-02-29 17:18:08.000000 ./usr/share/doc/spooles-doc/IV.ps.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 124031 2024-02-29 17:18:08.000000 ./usr/share/doc/spooles-doc/IVL.ps.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 95045 2024-02-29 17:18:08.000000 ./usr/share/doc/spooles-doc/Ideq.ps.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 204369 2024-02-29 17:18:08.000000 ./usr/share/doc/spooles-doc/InpMtx.ps.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 127736 2024-02-29 17:18:08.000000 ./usr/share/doc/spooles-doc/LinSol.ps.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 88844 2024-02-29 17:18:08.000000 ./usr/share/doc/spooles-doc/Lock.ps.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 175947 2024-02-29 17:18:08.000000 ./usr/share/doc/spooles-doc/MPI.ps.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 168155 2024-02-29 17:18:08.000000 ./usr/share/doc/spooles-doc/MSMD.ps.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 162886 2024-02-29 17:18:08.000000 ./usr/share/doc/spooles-doc/MT.ps.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 145900 2024-02-29 17:18:08.000000 ./usr/share/doc/spooles-doc/Network.ps.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 142963 2024-02-29 17:18:08.000000 ./usr/share/doc/spooles-doc/PatchAndGoInfo.ps.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 124098 2024-02-29 17:18:08.000000 ./usr/share/doc/spooles-doc/Pencil.ps.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 106676 2024-02-29 17:18:08.000000 ./usr/share/doc/spooles-doc/Perm.ps.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 149663 2024-02-29 17:18:08.000000 ./usr/share/doc/spooles-doc/ReferenceManual.ps.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 152437 2024-02-29 17:18:08.000000 ./usr/share/doc/spooles-doc/SemiImplMtx.ps.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 134041 2024-02-29 17:18:08.000000 ./usr/share/doc/spooles-doc/SolveMap.ps.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 175396 2024-02-29 17:18:08.000000 ./usr/share/doc/spooles-doc/SubMtx.ps.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 101016 2024-02-29 17:18:08.000000 ./usr/share/doc/spooles-doc/SubMtxList.ps.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 117197 2024-02-29 17:18:08.000000 ./usr/share/doc/spooles-doc/SubMtxManager.ps.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 120283 2024-02-29 17:18:08.000000 ./usr/share/doc/spooles-doc/SymbFac.ps.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 167399 2024-02-29 17:18:08.000000 ./usr/share/doc/spooles-doc/Tree.ps.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 189644 2024-02-29 17:18:08.000000 ./usr/share/doc/spooles-doc/Utilities.ps.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 127330 2024-02-29 17:18:08.000000 ./usr/share/doc/spooles-doc/ZV.ps.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 66936 2024-02-29 17:18:08.000000 ./usr/share/doc/spooles-doc/AllInOne.ps.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 126933 2024-02-29 17:18:08.000000 ./usr/share/doc/spooles-doc/BKL.ps.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 155162 2024-02-29 17:18:08.000000 ./usr/share/doc/spooles-doc/BPG.ps.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 189284 2024-02-29 17:18:08.000000 ./usr/share/doc/spooles-doc/Chv.ps.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 100034 2024-02-29 17:18:08.000000 ./usr/share/doc/spooles-doc/ChvList.ps.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 93737 2024-02-29 17:18:08.000000 ./usr/share/doc/spooles-doc/ChvManager.ps.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 119963 2024-02-29 17:18:08.000000 ./usr/share/doc/spooles-doc/Coords.ps.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 114764 2024-02-29 17:18:08.000000 ./usr/share/doc/spooles-doc/DSTree.ps.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 133066 2024-02-29 17:18:08.000000 ./usr/share/doc/spooles-doc/DV.ps.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 116760 2024-02-29 17:18:08.000000 ./usr/share/doc/spooles-doc/DenseMtx.ps.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 106756 2024-02-29 17:18:08.000000 ./usr/share/doc/spooles-doc/Drand.ps.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 120569 2024-02-29 17:18:08.000000 ./usr/share/doc/spooles-doc/EGraph.ps.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 219877 2024-02-29 17:18:08.000000 ./usr/share/doc/spooles-doc/ETree.ps.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 87009 2024-02-29 17:18:08.000000 ./usr/share/doc/spooles-doc/Eigen.ps.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 178772 2024-02-29 17:18:08.000000 ./usr/share/doc/spooles-doc/FrontMtx.ps.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 274548 2024-02-29 17:18:08.000000 ./usr/share/doc/spooles-doc/FrontTrees.ps.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 183517 2024-02-29 17:18:08.000000 ./usr/share/doc/spooles-doc/GPart.ps.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 189137 2024-02-29 17:18:08.000000 ./usr/share/doc/spooles-doc/Graph.ps.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 131207 2024-02-29 17:18:08.000000 ./usr/share/doc/spooles-doc/I2Ohash.ps.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 108955 2024-02-29 17:18:08.000000 ./usr/share/doc/spooles-doc/IIheap.ps.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 120719 2024-02-29 17:18:08.000000 ./usr/share/doc/spooles-doc/IV.ps.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 123677 2024-02-29 17:18:08.000000 ./usr/share/doc/spooles-doc/IVL.ps.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 94707 2024-02-29 17:18:08.000000 ./usr/share/doc/spooles-doc/Ideq.ps.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 204022 2024-02-29 17:18:08.000000 ./usr/share/doc/spooles-doc/InpMtx.ps.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 127056 2024-02-29 17:18:08.000000 ./usr/share/doc/spooles-doc/LinSol.ps.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 88525 2024-02-29 17:18:08.000000 ./usr/share/doc/spooles-doc/Lock.ps.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 175641 2024-02-29 17:18:08.000000 ./usr/share/doc/spooles-doc/MPI.ps.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 167873 2024-02-29 17:18:08.000000 ./usr/share/doc/spooles-doc/MSMD.ps.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 162593 2024-02-29 17:18:08.000000 ./usr/share/doc/spooles-doc/MT.ps.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 145561 2024-02-29 17:18:08.000000 ./usr/share/doc/spooles-doc/Network.ps.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 142635 2024-02-29 17:18:08.000000 ./usr/share/doc/spooles-doc/PatchAndGoInfo.ps.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 123760 2024-02-29 17:18:08.000000 ./usr/share/doc/spooles-doc/Pencil.ps.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 106409 2024-02-29 17:18:08.000000 ./usr/share/doc/spooles-doc/Perm.ps.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 148854 2024-02-29 17:18:08.000000 ./usr/share/doc/spooles-doc/ReferenceManual.ps.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 152119 2024-02-29 17:18:08.000000 ./usr/share/doc/spooles-doc/SemiImplMtx.ps.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 133690 2024-02-29 17:18:08.000000 ./usr/share/doc/spooles-doc/SolveMap.ps.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 175156 2024-02-29 17:18:08.000000 ./usr/share/doc/spooles-doc/SubMtx.ps.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 100685 2024-02-29 17:18:08.000000 ./usr/share/doc/spooles-doc/SubMtxList.ps.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 116851 2024-02-29 17:18:08.000000 ./usr/share/doc/spooles-doc/SubMtxManager.ps.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 119974 2024-02-29 17:18:08.000000 ./usr/share/doc/spooles-doc/SymbFac.ps.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 167103 2024-02-29 17:18:08.000000 ./usr/share/doc/spooles-doc/Tree.ps.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 189261 2024-02-29 17:18:08.000000 ./usr/share/doc/spooles-doc/Utilities.ps.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 126996 2024-02-29 17:18:08.000000 ./usr/share/doc/spooles-doc/ZV.ps.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 760 2024-02-29 17:18:08.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) 188442 2024-02-29 17:18:08.000000 ./usr/share/doc/spooles-doc/misc.ps.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 188081 2024-02-29 17:18:08.000000 ./usr/share/doc/spooles-doc/misc.ps.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 9600 2024-02-29 17:18:08.000000 ./usr/share/doc/spooles-doc/spooles.2.2.html │ │ │ │ drwxr-xr-x 0 root (0) root (0) 0 2024-02-29 17:18:08.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-doc.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 2024.05.17:2217 │ │ │ │ │ +%DVIPSSource: TeX output 2025.06.20:0449 │ │ │ │ │ %%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 │ │ │ │ │ @@ -2060,22 +2060,21 @@ │ │ │ │ │ /UnderlinePosition -100 def │ │ │ │ │ /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 49 /one put │ │ │ │ │ dup 50 /two put │ │ │ │ │ -dup 52 /four put │ │ │ │ │ -dup 55 /seven put │ │ │ │ │ +dup 53 /five put │ │ │ │ │ dup 58 /colon put │ │ │ │ │ -dup 77 /M put │ │ │ │ │ -dup 97 /a put │ │ │ │ │ -dup 121 /y put │ │ │ │ │ +dup 74 /J put │ │ │ │ │ +dup 101 /e put │ │ │ │ │ +dup 110 /n put │ │ │ │ │ +dup 117 /u put │ │ │ │ │ readonly def │ │ │ │ │ currentdict end │ │ │ │ │ currentfile eexec │ │ │ │ │ D9D66F633B846AB284BCF8B0411B772DE5CE32340DC6F28AF40857E4451976E7 │ │ │ │ │ 5182433CF9F333A38BD841C0D4E68BF9E012EB32A8FFB76B5816306B5EDF7C99 │ │ │ │ │ 8B3A16D9B4BC056662E32C7CD0123DFAEB734C7532E64BBFBF5A60336E646716 │ │ │ │ │ EFB852C877F440D329172C71F1E5D59CE9473C26B8AEF7AD68EF0727B6EC2E0C │ │ │ │ │ @@ -2256,72 +2255,64 @@ │ │ │ │ │ 7CA1534C4D5B05FC33F83790ECFD7641DF3FB94289E2A1F6E7D29AB1228A867A │ │ │ │ │ 6E1EF0E9C6F899B491DC18401C2C0A05FFFED46A72C245F7529B8EA55A038082 │ │ │ │ │ 8512307217D2A233C37004085BA3AEE379269F9FA7D0ADB4B19A95CC2AFE686E │ │ │ │ │ 55D88E47257C1FE6F235FEA295910569FE6DD5995512562359CC821E85A6C7A5 │ │ │ │ │ 79B470A9E340A6985189FF8B6AF914A6B0ECF93F47903221F95DE894A8F05B05 │ │ │ │ │ B7D99CD533EC5F931B18E6B39BECF67FA2D6DD1AEC76772B068BE06335A94C05 │ │ │ │ │ 7A4DDEE77B66101DA855C17AC312600370B34E31F5EC3A01300A8EB60B4C9767 │ │ │ │ │ -1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004B9BA1CC │ │ │ │ │ -580D3C6BDA4DC1B80B4365F1C80512453FC5316EC2D928FB731C3D6403E3C18B │ │ │ │ │ -E8424D644DF5E9A2134229C5C91CA68DB8E85BA2BB40F538F585DA6FA4037718 │ │ │ │ │ -B8053EBBA1E765346BCD5BDAA6C38115D31611D8A87A2238C145F2DA2F92E4DF │ │ │ │ │ -3987BD9C4D2A3D460E8941A68B125BCD9EE4F9FD262C4C8A71F47A2C81975635 │ │ │ │ │ -F1B981C274C53FA2ACCDE4C9D0A7C62D6C1EFF91CFC6712CA6A9F333C9564FCB │ │ │ │ │ -2A70F0AD715A79B10A08AB069E2A3C93BC0AED19D0CA10134B8DDDE8AF548DB2 │ │ │ │ │ -3A4AAA9C29682CF135BB767DAA16169A127EB50A7EECEB6480CF56A7D0F8AC56 │ │ │ │ │ -4A5090B3D75A790372886AF568D94C8165975A05BFBFDF1FFBA45F70700BB9E0 │ │ │ │ │ -57F3249EF9E9C8AD9CBCF6E4FD592DC4CDD2CC7C0BC3130C1059096C657BE453 │ │ │ │ │ -A2CBACE93420210E27AF56CA229BD6D982FB68B3FDC6D44478B922C4231C47EE │ │ │ │ │ -E500232F6C11D92DEB955F66DF52B92B22E7352790CC2DCBAC53965D57AC2920 │ │ │ │ │ -68B7D520DE25047146EFEB06B9AD4E2A94243C7E5239F0BC2FC312B16051D52C │ │ │ │ │ -0B92C217B6B42997321AE4F8BB066754B7AA3F15069EF59224E8A442CE471AA7 │ │ │ │ │ -E8049A3DD9EDA09CCEE4998998661CF7DB35E952F6C65DAEB3013951C59F3E09 │ │ │ │ │ -157F313B0237876E1C0190F0473819570B8C0205AADF05D787CC00979CFB327A │ │ │ │ │ -289382B22DDA6F12804ED0ED5B179E36A995A2A59E1B66E75130DBE9109C813B │ │ │ │ │ -94403E0DEA8314A1E9DB474D7FA83C0BAFD08033E6A6215844C1D26BE15F1251 │ │ │ │ │ -A1605E8DF9A9C601ED37379530BC1C82BE5463C6C711C5652BFD6262485AA9CA │ │ │ │ │ -B8C4A117593001D08D980041E2A83C190DCE8E6CD3D334E5CC19FC05DB30F7F7 │ │ │ │ │ -24A305C4DBB31F0651392B99D44B4302333BDF7E326FD256DD75D309C6E73F85 │ │ │ │ │ -FA71B35FD1F9BEFF4C7A1076362EEB0A85492933B6006086A7B8C1928CF2D1EE │ │ │ │ │ -FD4344409257BB802C117E739960821CD3C88BFBA5669FF16F610AD638AF3677 │ │ │ │ │ -8674C985E6767253ED5769F71BEA5E9BB02A751F9E62EE2B18AC19D975FDEAE9 │ │ │ │ │ -8B8822367FF177A7E850766DE99ED3366D46464612926430012212A90F8E85F4 │ │ │ │ │ -4760B40D5B86B90819EE410382C23E86DCAF4F0FF5DFEB2C285965F4DCF2FB2B │ │ │ │ │ -457C0A0427A8D4ADA514E9DACD0F9367E1DA225DB21DA4DDAE33F2B529686D92 │ │ │ │ │ -AC085B345565F9DFFA012FD494DBB2E0B44A0787B2B72DC8D25399DAAE8864B7 │ │ │ │ │ -E84AA99DAFCEAF18F8B41882720316450F1B1CA48B418C9736E5CE4AFF996111 │ │ │ │ │ -5F7FE80958B6A3498508E9693CB134402D92E30D4C2939070D4647E13682290E │ │ │ │ │ -1D0820A3FCA7147157D09D1A40771F214EAE7DD743EA26839E535CA186C05CB8 │ │ │ │ │ -4874988AA1104D85AF0220FE7224344FF624E794BD2454E1C0AC971522FBECBA │ │ │ │ │ -B2497F25CD621B77EC5160973EF5ECC39C183DC051B0DFCB090194A2525BD96E │ │ │ │ │ -28593FDA80D8D259F039416D5F9AF0AD3C9A105B49DAF6E681921E369B7666C6 │ │ │ │ │ -2B73DB37447B00AE96317C2F1C44FB6E6EFD740BAB20FA03A8CE018EC8415582 │ │ │ │ │ -FB06E88A2971E3A480FB1EB4FE93CC7E5179721CAABEE88742B13CF0405F49F4 │ │ │ │ │ -945E587668C821D8C06D6847B6DF84CAFFCD4628670D551FC5F7236875BE1207 │ │ │ │ │ -634BA7F70A19B658FAE7D86F6D00ED28FBF29CC585DEE279325EEF8B0CCB6149 │ │ │ │ │ -E46E638C73D75148F18A636DBC2DD96ED34F68A5A09A3700B1EA34B2D142807C │ │ │ │ │ -F8709D81180783548EAE6F457BF968602076A1069163E3C15BBCEF659C6CF2E6 │ │ │ │ │ -0BB01BDC8E503802CC7969A5B8477E9788C5249B23B19669F5075E089738E49A │ │ │ │ │ -8671D7C1B1B47652F3D78BF2FF74EDB44BA5B092E8D5B85001E97F69D54AEEFC │ │ │ │ │ -88FC3CA1B0D5BAC39263B371005BCFA19AD197A31CC34D0BD55C2CA18C60C485 │ │ │ │ │ -5993F736EF1DD2C5D2B4D50B3D498861B4DF5E7AFF614BBCA4C2E6BECC0DCEF5 │ │ │ │ │ -95F0D686188014C530D8E37650CDCAE721B4AFB0F178BC744BDDDED45DAB7FEB │ │ │ │ │ -A10B975E26099E3DC61116D6BF554574F948895B88EEFE03DCC5351190836AD4 │ │ │ │ │ -EBC1AC55C6D099A8E7B0A372D290C481F44FA464B9C11A0BC991CB045E0AAAC4 │ │ │ │ │ -5C73CA43A4F17D1ADDD33D1B917FF95BFF411C8409F41553B1BC97DE47E3A1F4 │ │ │ │ │ -A5C1D1B7B1BF7E2507AC53956C141411F4F657E37981996DD7BB7ADB2CB6AE01 │ │ │ │ │ -73D0876B8F896F626D5022FE53BA34D5668BD698BE8D5CCAD083CBCEF440BE6A │ │ │ │ │ -8090EB1CDEE5F99C8988650BD4E539B357C31C597D8A9104A9D5967D4E906CAD │ │ │ │ │ -2A65575A884B1C5F6CC509E742FA9DDD66494F219178161AF72C50848E226A95 │ │ │ │ │ -A8C247FF9FF0BABD073021271B5C0692F9BE220071DAB09E5A026629371EE3C4 │ │ │ │ │ -A6E4FA94625D87A5B66EF077ED54C72B1052AEAA9637B30C76EF8EB04AD5F476 │ │ │ │ │ -D15F1C93C0BC6E0F67B366097BBED03FE82C040F9EF02866159B46854E11D44F │ │ │ │ │ -54AE6748A7E61B993A4EECD3B8BE3B5897A66BBCDFE24F65BC2AD5AB49048CF1 │ │ │ │ │ -647203823F84DF5CB483096F9D96AEE3A2855E479B72A14A67C633CE99C101CF │ │ │ │ │ -EFAE939BF9B02E710D │ │ │ │ │ +1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004ACD1870 │ │ │ │ │ +A5EA947858F5795870BFE1343AD803FB854BF8F5A4E794E8EC57BE41DB5B8734 │ │ │ │ │ +13E47950F29A81EA0C81EA798863883D7F41F78325CA190CBBFFE822AE494550 │ │ │ │ │ +4BE83703071FC9512D128927AF3F63CEF8F86ABE1E15D7B4DDD39576E7DFF45E │ │ │ │ │ +3CB4115AAB1830DE8647B915DB4BEBEB5235C281E098B899BAB951D8D5798F01 │ │ │ │ │ +7F7C47336D31438E5126738AFEAB29E9A7CBE06DE4DD604477B542D2620DFD58 │ │ │ │ │ +28FE34238572F23C5A8EB7ACEE1E154DA13FC1A5AA67A3BA8C5CDFB2B80312C9 │ │ │ │ │ +BC9FAE56D08DDFA9498E6EF0D0F6BD18B3923E0B670B0740528BC843610736CB │ │ │ │ │ +80228C105C2F72C3C22D610C3D8C268DEEA2AEEE3221E198E79FE2966487360C │ │ │ │ │ +84AE08AC326F48B21447652121B1EB68AF856055EEA65B6B625BF622CBFC2D1C │ │ │ │ │ +EF943CC4CAF2C715782C9EF9A9BA4689BFC6B6A82F8D55795BE8111E2C7DE520 │ │ │ │ │ +367362304B6A48186C842033E715A46265A352472F4F7313248EBCD26BEA97E7 │ │ │ │ │ +B814A61D4B7ADCB5C5F21AA34E0C1269E8426DBFB511DE6E26B960456C8F8520 │ │ │ │ │ +5F0DD382289A62AF0B935EDB5B2394538C5F0EE72962D2F98F3C38CD7C027B9F │ │ │ │ │ +E230E67E40FEFBDED06B3423C9DFD669E6B5BC913E0FF75786A64A6C11D4FE89 │ │ │ │ │ +1B918DC0E953C52CFD153063CD0D2A78B43F8712243845E6F2CBA1DB610F403D │ │ │ │ │ +A98D06D95FF44C7AC029092B666A8B0DCEA95B34F5ACC10E8611BADE6A24469C │ │ │ │ │ +0C01D95BFB445FA22CD38D033E4D24E006BB9D54EE41EF7AD5AC9C299721F61A │ │ │ │ │ +F01B6EDCDF428BD9195A13C5B1027358F8A203F828A1DD9622243B2D76C6F1BA │ │ │ │ │ +9F2D7E9D4879FC668ABC750CD25415DC6CCF2257C28F78D3F9BE499CC0FF2F80 │ │ │ │ │ +2C2CD1DEFABD6668FCA76E1D629A344333E33DA24B86D2E9F8F5EE1C29974640 │ │ │ │ │ +C3E78E999BAB313400041DADDDFDBFFCC419F129A84F4D412B79E8BE4511CA00 │ │ │ │ │ +F92A4F3CDD2E51345D3965C104F06B6503445DC20224CB7606A9D7D5F9EE45E6 │ │ │ │ │ +1B2963DA96AA2AB1BA5BE29656E666E4D0E122DE58EEA68E04ED76438DA03E65 │ │ │ │ │ +B80055A86B7B2A26BAE6BBB8835E17F9696E9B3CD34571BA75C76D4D2CCC48F1 │ │ │ │ │ +7534C1EF9127E374D65D05B8072E08D6C72A0B4A35EA0DD717743C66D105CCD8 │ │ │ │ │ +7355F13E9C38C1A4351624E689ED7909100942FA0474842EE44DEC3279E1A1CD │ │ │ │ │ +8064666EB845CA7C3E906B67C0BF96A28D514DB2E4A1E4AF287350B03762A2CF │ │ │ │ │ +13B18AC3F5D2F3B74A1D50267C03EFB74B888E1D24ABEEA4A885F4D0BF14C0D8 │ │ │ │ │ +289AC79D6D98E2A2C831672FB1F3457564CD161ADC3AF610D88201AB5B0C10CB │ │ │ │ │ +5ECCC2D5C4AF39C8CB3044BF9EC791BA45D29C2B51EA0483D19822C264CE6FA3 │ │ │ │ │ +5C97F2DF5A78CB93528E99B9ED7CB121C83130C129B849B52A36EBD88AF19DD3 │ │ │ │ │ +C5CABE831027388EF86BD5CBD90AAAC089775938A321C44D4DDA67A51312D8AB │ │ │ │ │ +C509DDBE7044A107AB2BE9C4C9556F85C529B174A7778B489BF28EC07A834542 │ │ │ │ │ +8B31F2925C21FB2096877711F998763D5A8495002B8E080AF8DBB1B3106EDDBA │ │ │ │ │ +35121D52E0846A7AF3ABEDF87BDE4FA665673A9B80CA538B98F873947AA17EF4 │ │ │ │ │ +9BB182917E9D79BC7EC681E93710D6A1D6B0E4A7FA9452FC1C431808174F3AB7 │ │ │ │ │ +F3914FBC86CB34E8583457243C3C7BE4BC166C7397689BC6FFB82EA2967E88EE │ │ │ │ │ +464F96EDA144DE2B64401B8E577ABCA2D826FE0B92E21FFAE3E81EBB6B6EB36E │ │ │ │ │ +9B1A8FE3884CA398C03135FD49D51724FC1268E9482E41FAEA2FC6C809006B8F │ │ │ │ │ +5D4F9E038450AD3A6041C16FD1C7E5FC80C0E033CE57E64863E014531D94DF1E │ │ │ │ │ +31D7D038AFCB60715AA73C1E96F113A24C5AF35BBEB61C4D079ED034ED83AA4A │ │ │ │ │ +E12448E618330463304788BCF40561CD63167B3BF144F408E2B89E60B8BA13EF │ │ │ │ │ +3B57D286FD23D4FA8BAEFF98DC1188B1982956CC1DCAEFC7D949B7B4E3BE8F8A │ │ │ │ │ +BFE2C9D938DD13EFEE7123576608D9396F260907DA98AE2D3DD5822306CBC8A6 │ │ │ │ │ +B083C697DDA3C62EE7879436A9FD8EE0034B105105B3F122F893EA2126EBE8A9 │ │ │ │ │ +5CBF2BD248DD9FBEF0040C25797BD13B69A8C9F0D4E4F935C61ED30487CCDB1A │ │ │ │ │ +0339006E78EE1755929D2412776EC7DB1F666DBDD28EA8AC7397F809C7F38A41 │ │ │ │ │ +5B3BF6C75F4F35C90141EB08377AF452CF840FEA938805F9D14E02DC29215B4E │ │ │ │ │ +F1EB │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ @@ -4609,16 +4600,16 @@ │ │ │ │ │ %%EndFont │ │ │ │ │ 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 │ │ │ │ │ -23[42 19[76 18[23 2[42 2[42 1[42 42 42 3[23 44[{}10 83.022 │ │ │ │ │ +56 56 56 56 56 2[31 46[{}33 99.6264 /CMBX12 rf /Ff 138[46 │ │ │ │ │ +6[46 8[37 26[43 15[23 4[42 2[42 1[42 3[23 44[{}9 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 │ │ │ │ │ @@ -4743,17 +4734,17 @@ │ │ │ │ │ 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 1311 4 v │ │ │ │ │ -1476 w Fl(A2)27 b Ff(:)37 b Fh(DRAFT)27 b Ff(Ma)n(y)g(17,)g(2024)p │ │ │ │ │ -2589 100 V 0 390 a Fe(1.2.1)112 b(Basic)38 b(metho)s(ds)0 │ │ │ │ │ +TeXDict begin 2 1 bop 0 100 a Fm(2)p 125 100 1305 4 v │ │ │ │ │ +1470 w Fl(A2)27 b Ff(:)37 b Fh(DRAFT)27 b Ff(June)h(20,)e(2025)p │ │ │ │ │ +2595 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 │ │ │ │ │ @@ -4812,17 +4803,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 1311 4 v 1477 100 a Fl(A2)27 │ │ │ │ │ -b Ff(:)37 b Fh(DRAFT)110 b Ff(Ma)n(y)27 b(17,)g(2024)p │ │ │ │ │ -2550 100 V 1311 w Fm(3)101 390 y(6.)42 b Fl(double)f(*)i(A2_row)e(\()i │ │ │ │ │ +TeXDict begin 3 2 bop 83 100 1305 4 v 1471 100 a Fl(A2)26 │ │ │ │ │ +b Ff(:)37 b Fh(DRAFT)111 b Ff(June)27 b(20,)g(2025)p │ │ │ │ │ +2556 100 V 1305 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 │ │ │ │ │ @@ -4893,17 +4884,17 @@ │ │ │ │ │ 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 1311 4 v │ │ │ │ │ -1476 w Fl(A2)27 b Ff(:)37 b Fh(DRAFT)27 b Ff(Ma)n(y)g(17,)g(2024)p │ │ │ │ │ -2589 100 V 0 390 a Fe(1.2.3)112 b(Initialize)38 b(metho)s(ds)101 │ │ │ │ │ +TeXDict begin 4 3 bop 0 100 a Fm(4)p 125 100 1305 4 v │ │ │ │ │ +1470 w Fl(A2)27 b Ff(:)37 b Fh(DRAFT)27 b Ff(June)h(20,)e(2025)p │ │ │ │ │ +2595 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 │ │ │ │ │ @@ -4987,17 +4978,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 1311 4 v 1477 100 a Fl(A2)27 │ │ │ │ │ -b Ff(:)37 b Fh(DRAFT)110 b Ff(Ma)n(y)27 b(17,)g(2024)p │ │ │ │ │ -2550 100 V 1311 w Fm(5)101 390 y(4.)42 b Fl(void)f(A2_applyQT)f(\()j │ │ │ │ │ +TeXDict begin 5 4 bop 83 100 1305 4 v 1471 100 a Fl(A2)26 │ │ │ │ │ +b Ff(:)37 b Fh(DRAFT)111 b Ff(June)27 b(20,)g(2025)p │ │ │ │ │ +2556 100 V 1305 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 │ │ │ │ │ @@ -5065,17 +5056,17 @@ │ │ │ │ │ 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 1311 4 v │ │ │ │ │ -1476 w Fl(A2)27 b Ff(:)37 b Fh(DRAFT)27 b Ff(Ma)n(y)g(17,)g(2024)p │ │ │ │ │ -2589 100 V 101 390 a Fm(9.)42 b Fl(double)f(A2_twoNormOfRow)c(\()43 │ │ │ │ │ +TeXDict begin 6 5 bop 0 100 a Fm(6)p 125 100 1305 4 v │ │ │ │ │ +1470 w Fl(A2)27 b Ff(:)37 b Fh(DRAFT)27 b Ff(June)h(20,)e(2025)p │ │ │ │ │ +2595 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 │ │ │ │ │ @@ -5148,17 +5139,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 1311 4 v 1477 100 a Fl(A2)27 │ │ │ │ │ -b Ff(:)37 b Fh(DRAFT)110 b Ff(Ma)n(y)27 b(17,)g(2024)p │ │ │ │ │ -2550 100 V 1311 w Fm(7)208 390 y Fh(Err)l(or)j(che)l(cking:)38 │ │ │ │ │ +TeXDict begin 7 6 bop 83 100 1305 4 v 1471 100 a Fl(A2)26 │ │ │ │ │ +b Ff(:)37 b Fh(DRAFT)111 b Ff(June)27 b(20,)g(2025)p │ │ │ │ │ +2556 100 V 1305 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 │ │ │ │ │ @@ -5232,17 +5223,17 @@ │ │ │ │ │ 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 1311 4 v │ │ │ │ │ -1476 w Fl(A2)27 b Ff(:)37 b Fh(DRAFT)27 b Ff(Ma)n(y)g(17,)g(2024)p │ │ │ │ │ -2589 100 V 60 390 a Fm(13.)41 b Fl(void)g(A2_setRowDV)f(\()j(A2)f │ │ │ │ │ +TeXDict begin 8 7 bop 0 100 a Fm(8)p 125 100 1305 4 v │ │ │ │ │ +1470 w Fl(A2)27 b Ff(:)37 b Fh(DRAFT)27 b Ff(June)h(20,)e(2025)p │ │ │ │ │ +2595 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 │ │ │ │ │ @@ -5317,17 +5308,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 1311 4 v 1477 100 a Fl(A2)27 │ │ │ │ │ -b Ff(:)37 b Fh(DRAFT)110 b Ff(Ma)n(y)27 b(17,)g(2024)p │ │ │ │ │ -2550 100 V 1311 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 1305 4 v 1471 100 a Fl(A2)26 │ │ │ │ │ +b Ff(:)37 b Fh(DRAFT)111 b Ff(June)27 b(20,)g(2025)p │ │ │ │ │ +2556 100 V 1305 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 │ │ │ │ │ @@ -5414,17 +5405,17 @@ │ │ │ │ │ (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 1291 4 │ │ │ │ │ -v 1455 w Fl(A2)27 b Ff(:)37 b Fh(DRAFT)27 b Ff(Ma)n(y)g(17,)g(2024)p │ │ │ │ │ -2610 100 V 101 390 a Fm(4.)42 b Fl(int)g(A2_writeToFile)c(\()43 │ │ │ │ │ +TeXDict begin 10 9 bop 0 100 a Fm(10)p 166 100 1284 4 │ │ │ │ │ +v 1449 w Fl(A2)27 b Ff(:)37 b Fh(DRAFT)27 b Ff(June)g(20,)g(2025)p │ │ │ │ │ +2616 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 │ │ │ │ │ @@ -5501,17 +5492,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 1291 4 v 1456 100 a Fl(A2)27 │ │ │ │ │ -b Ff(:)37 b Fh(DRAFT)110 b Ff(Ma)n(y)27 b(17,)g(2024)p │ │ │ │ │ -2529 100 V 1291 w Fm(11)307 390 y Fi(\210)42 b Fm(The)28 │ │ │ │ │ +TeXDict begin 11 10 bop 83 100 1284 4 v 1450 100 a Fl(A2)27 │ │ │ │ │ +b Ff(:)37 b Fh(DRAFT)110 b Ff(June)27 b(20,)g(2025)p │ │ │ │ │ +2535 100 V 1284 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 May 17, 2024 │ │ │ │ │ │ + 2 A2 : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 3 │ │ │ │ │ │ + A2 : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 4 A2 : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 5 │ │ │ │ │ │ + A2 : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 6 A2 : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 7 │ │ │ │ │ │ + A2 : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 8 A2 : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 9 │ │ │ │ │ │ + A2 : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 10 A2 : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 11 │ │ │ │ │ │ + A2 : DRAFT June 20, 2025 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 │ │ │ │ │ @@ -10,15 +10,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 2024.05.17:2217 │ │ │ │ │ +%DVIPSSource: TeX output 2025.06.20:0449 │ │ │ │ │ %%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 │ │ │ │ │ @@ -1372,26 +1372,23 @@ │ │ │ │ │ /UnderlineThickness 50 def │ │ │ │ │ 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 49 /one put │ │ │ │ │ dup 50 /two put │ │ │ │ │ -dup 52 /four put │ │ │ │ │ -dup 55 /seven put │ │ │ │ │ +dup 53 /five put │ │ │ │ │ dup 65 /A put │ │ │ │ │ dup 66 /B put │ │ │ │ │ dup 67 /C put │ │ │ │ │ dup 68 /D put │ │ │ │ │ dup 71 /G put │ │ │ │ │ dup 74 /J put │ │ │ │ │ dup 75 /K put │ │ │ │ │ -dup 77 /M put │ │ │ │ │ dup 80 /P put │ │ │ │ │ dup 82 /R put │ │ │ │ │ dup 87 /W put │ │ │ │ │ dup 97 /a put │ │ │ │ │ dup 99 /c put │ │ │ │ │ dup 101 /e put │ │ │ │ │ dup 102 /f put │ │ │ │ │ @@ -1401,15 +1398,15 @@ │ │ │ │ │ dup 107 /k put │ │ │ │ │ dup 109 /m put │ │ │ │ │ dup 110 /n put │ │ │ │ │ dup 111 /o put │ │ │ │ │ dup 114 /r put │ │ │ │ │ dup 115 /s put │ │ │ │ │ dup 116 /t put │ │ │ │ │ -dup 121 /y put │ │ │ │ │ +dup 117 /u put │ │ │ │ │ readonly def │ │ │ │ │ currentdict end │ │ │ │ │ currentfile eexec │ │ │ │ │ D9D66F633B846AB284BCF8B0411B772DE5CE3DD325E55798292D7BD972BD75FA │ │ │ │ │ 0E079529AF9C82DF72F64195C9C210DCE34528F540DA1FFD7BEBB9B40787BA93 │ │ │ │ │ 51BBFB7CFC5F9152D1E5BB0AD8D016C6CFA4EB41B3C51D091C2D5440E67CFD71 │ │ │ │ │ 7C56816B03B901BF4A25A07175380E50A213F877C44778B3C5AADBCC86D6E551 │ │ │ │ │ @@ -1588,209 +1585,192 @@ │ │ │ │ │ 34DE10D995ABCAF45FBB3B6B73E80D05F4C51F8C29D4B0F67C8A86432A6C5E86 │ │ │ │ │ F0126AB25A5CA2875B48C61CB8112A4CF9AA08F8B0157396CF63CBECDB8867CC │ │ │ │ │ AC10F060630C9BFBAD84B1FF01C814878F0C177F552BDC9BB181B14581C6E968 │ │ │ │ │ DAAAB2896FCFB745795C4D2C87CC15BAA041EF80C5BDC12EC1F5786BB41A5A21 │ │ │ │ │ 073EE0BC436B346E014DB4099EDC67BC432E470A4B779FD556341061CA3F2BE8 │ │ │ │ │ EFA332637AEC878C2BB189CA3267B2BE5B8178E6B7889A33771F86276E6F0B8E │ │ │ │ │ 8E93B816AC7005575762EF4DE45E2794B7322F9B6D8E634FB8FF250D638EB502 │ │ │ │ │ -818321B3C46DB51B8EC6C2EF1D05C716519A3BD6B12A67239898F8A010CD1ECB │ │ │ │ │ -5F98B639B1CCA391E8E72C3B7BCA757603E45860252B9430C2B59108094C406E │ │ │ │ │ -3488A7B276447B996367CAC4B345C878EB62E1A25B4FA057A5AA4AC1F48CDB0C │ │ │ │ │ -8AEA68F7CE7DCF59E58483DBC9BDD003771B04CC1AC3A0BA98AD9CC43DF7CC38 │ │ │ │ │ -72CB2C8DE93596934273247D48FA99288E762B45EA5A53EF684DE34B2A258F91 │ │ │ │ │ -FFA8F98747970CF629A6AA0B502A12C052C618EAC473F8F71933A1249F78E167 │ │ │ │ │ -F8F63A74FAF011ECAF83656F61D94D2083A6E96E7433C74DBD75B59A700980BA │ │ │ │ │ -6F10E8B58DA52ABD314BA086D9D03527F6B60037F883B74E4B268BCB101B0DD5 │ │ │ │ │ -AD78BEC9ECDB537CC30DA36CB6A89269964AAB69D0496F7B066F6E6BB9DB874C │ │ │ │ │ -E5A7D81EAB79F6F3BD7EE8980243CAC635045E36384181357D5B27F0081A0C5F │ │ │ │ │ -C8D6DBBA75A36F394BDD94BF384052B0F49C8AE0F44E4DE57EE3D1C7FE73B242 │ │ │ │ │ -A69A5CB53064013162122BB97555452CDD3D06645171DE53FADF72425A518092 │ │ │ │ │ -ED601B61ACD5AF2E7C68E72A147F29630DD3383589EB195B842F3FB1D5D02CB2 │ │ │ │ │ -FD370592D78AED95114A409B7C64A3CF625EDEBC194F5DBAE70A5E643AD50465 │ │ │ │ │ -9750ADC1F788EB274F9D8B573A93ABFBF0AE15AA59E6C62DFF92AE3A69A13BCA │ │ │ │ │ -596CD20AE2D9257B1CD8E678BFD9A8E659284AE3DCD521BDCA97D4F65F6D03B2 │ │ │ │ │ -042D540AB72E504830F03AEA815E662667A3EBC84EEA8D5765C590512D138C70 │ │ │ │ │ -674BFE85C088A1012EEBD6F051BAEFEB67AB4E46A34E26B52D0F438442EC7934 │ │ │ │ │ -59274364A388BF5EC671E4E5BD9DD22A75BED3BEE56EC6ED196AE15AC0EC9CB5 │ │ │ │ │ -F60FBEFD59F10992FCCD3C2FC2C82BA701D32222C3A260C39FF6F62DBC786F26 │ │ │ │ │ -39A79A62CA866FEE75A9EDCC35232FAE9ECF5BD170EA05C1A9DB9B513B7DD837 │ │ │ │ │ -A6BDFF7E1CB3509E78965A78AB494DE656DD8F62ED71A718AFADA019B74C1E51 │ │ │ │ │ -BF18C629CA84EEC48CA9B8352C90CCADBC305461BBE12FB165B64CE5C432409C │ │ │ │ │ -B6200C83D3513BBEC1243870A777C1A4B00BB9EFB3A6B1878B95A37E7276F706 │ │ │ │ │ -1934CDC8E5DB2E59189B0C050511A46FACAD4C10E9BD97363CBA94BA7078C922 │ │ │ │ │ -BE901E5A6A9AF5A2B1621AD069C4D3B23D7A286B51F6431DE0F8FEB60968584E │ │ │ │ │ -0152DD2F3E22FAB55681493F3EF485C6D90DA4C7E9B8685BF37D2DB722705EFC │ │ │ │ │ -5A723570986E41712FE5313BACDAC38D3F64B18B9530539F3257033D750172BD │ │ │ │ │ -3C6F7E79A6A830D750576CC72846D1B8C15A1913A9FC201CC047D266F1435573 │ │ │ │ │ -8CCED0E3709F1EBA4315CA9820CDE8792ADA4FBE882121CFC8C3EFFB8D17C3C0 │ │ │ │ │ -9D8590016461CF2A62105956030072474C286A51169C0D739070E389FCF93A78 │ │ │ │ │ -4E04169E885247362D5FC6E8C4C442EB31B45FD77E6A737AB9F7A26FCDAD407E │ │ │ │ │ -71A8667B9F6CE41A7B471DEA248BD050690FD0C3FCA1A957DE7C04371671D73E │ │ │ │ │ -ED83541193621FA64F3297F2FD078860AA27AC73AB87D28CCA8F08C18A11A8B4 │ │ │ │ │ -5A65BC4F02EC42E9EFE4168664EBE67A7630BE895FF71E83926287A75EB3D367 │ │ │ │ │ -6C4805FC3BC0A1D5B035611C24BDF08B24F10AF054552BC4F25D71844180256F │ │ │ │ │ -E55BBB28EEC69F3D249850876DE823B29B36834E064A2538FBC7A3816B611045 │ │ │ │ │ -607CC59ADD4FE5E39B6393CA6E5BC5D264C0AC832009EBD749C629C67B930B2B │ │ │ │ │ -FF171BDE6815D298B310794C31DE5794670BBB29A27183F1BEC984135708F31E │ │ │ │ │ -4EAF96CAA66984CC4D909D9CC03D453234C6E7B6934A1951D0F77FC8E9894C54 │ │ │ │ │ -56EAC16926E7FF228116F97E24B8C1C11B1BCDBAEDE9E8FFD0FAF5B4BBEC5416 │ │ │ │ │ -50D8B945D930EA91796192CEC218048BCA4AF105112798545800C6D74F76EEE7 │ │ │ │ │ -B1BEA2BA2B510C5139641983B92CE5E1602CA30A576ED07812F9EAA22DAD8522 │ │ │ │ │ -B0BEA7246658BE05ACA13C7ADEBCF8B80090C3C041D7741AD900C9DF0ECE9134 │ │ │ │ │ -7AED9E5A1866D4D377C6518B4B873179600EA91BB5AD7E956B6EB6FD91D378CB │ │ │ │ │ -5AFCA2C7ACFDC5D134911B5115C55F586A761FCC835BBD9D4E01CE87008703DB │ │ │ │ │ -80AB9EDE17DC023A75063BFFBC89339FA9B9B9DB537AF363616EA5E151077D70 │ │ │ │ │ -ABB16ECFCEBEC739E44D6EAA04306C1CAD2B391B713F8DA051EC4A75A1EA264E │ │ │ │ │ -053963A0165A52EB047D619FB4AAEA611A49C75A080FD364AC278FE3F06B0C47 │ │ │ │ │ -D7E38D165226C5F88F2FE443ED1DB263AB0AC36D125B57BCB5550709E1692730 │ │ │ │ │ -D991FCB5B03BA9944C6DBF9CBA343CBFFB5E4202FE3E26BD1746C2001DCCD5D7 │ │ │ │ │ -6C151CCBAF2F185B1BDEC9BFB725BE5EABD84C82C53A1B5F060AACEE4C9B6E8F │ │ │ │ │ -9170B138E876537A2916EEDB31D2C1284D2137AD5244A541FC4DEFF5EF936741 │ │ │ │ │ -AA460231E71E8C8C4321CEFAAE682B910CD867F071C29AC41DB148869254E7C0 │ │ │ │ │ -76E9D0B900C30D8A16EB75BDC0D43C28632B05AE5F00AC323C23D292AEA51D14 │ │ │ │ │ -37E10DEC5DB7856DF23299D69F18989CBBE59DE4A8C40CCBE2030ECD119CEB45 │ │ │ │ │ -C59C47EF868AC4807F7A446666A1A237AE097199319BBC6402DBB59F4C917BF4 │ │ │ │ │ -416EA993E58A1FAA3A2579A8AFE2A4EE29A75CB46269963D6CA26836BC5CC1B0 │ │ │ │ │ -5C970D47D0BB1343EE17F9B8A0A14185D20D6013D6E1EC7CBF6C6CCA5D2B36CE │ │ │ │ │ -F480A78625A082F94B09B5E3438AC7FF73842A112674A4A315E261DB0076013F │ │ │ │ │ -7DDBB187B43E272FC99D32493E1E62E607D489C14480C079DCC36BCD73D1637A │ │ │ │ │ -40BE6784C6A3026ECCEDDD0F5FAD687E13BACCC373C0EFF0D8CC93622F2810F4 │ │ │ │ │ -E2E6F17B7DBC1B8704F92F5BA693A67C3D6D1B681620BB08EC4B53F6BCE54864 │ │ │ │ │ -DBAB3C39DBDC0A4205222ACAA29AA2D899AADBA8D7DBC69B320274F8055D8156 │ │ │ │ │ -0AA7D1BF86411B912E7CB3BECD1A2BDE0C4B957F897BF53870A0CC3A8968CCC4 │ │ │ │ │ -A2650063E4601AC24C36EA460DB95DDC776A8766C0BC7839AD9FE2AE61C451FC │ │ │ │ │ -14DD1421C45280322DEB9D4D4CACD43DA1E3FA2453D4B8F4C2226B6E1ADD53B5 │ │ │ │ │ -10AC519F2E6EA009F409CF5FC2BDC371B17566F2FFFACC7C030D8AAB8FDD2DAD │ │ │ │ │ -989E96D37A9C45C68F188437F76AEDFD4E0EF72FF7F2938FD7DA578AA096655D │ │ │ │ │ -BC1259ED9AA7FAA6E4782DB172D60F08094ECF2653B1A909D04F0DB412912921 │ │ │ │ │ -1F1E3461DCF8262A977BCEEB5E41C4A529D758581B1D698803FC1DB6C4316357 │ │ │ │ │ -C04BF26CD7EE22A88D9A1F1E0F3D1847748AB7EEE23B29500C025C0091459CB2 │ │ │ │ │ -B76CCEE52CB3D59FABD71952489A56F1A21C20A844C04B627214790B6A83A282 │ │ │ │ │ -8E0FAFE96E16B651B24EEF6083A06D5B90E3BD45494BEAE4DAA2EB1791876F99 │ │ │ │ │ -7BAB849025EE9EB3F3F39B1E155D14B253E767D6A76677D6A6820CF96020CF68 │ │ │ │ │ -03D63E53CA774821585C339FCE143437531C7AC8EC34172685DF6025C9955E4A │ │ │ │ │ -77C201B5D53A12D86747E7EB15D8A3BB6BF8DFD2A2F32C26C4753B1D410753FA │ │ │ │ │ -B30FA2429D2952DDEF4EEB1822B5526CCB09F1B93FB44D400A048FEA15AE04FB │ │ │ │ │ -E1757AFE29F5591199C217521D1C3C5422558E58B7E05F184884AE33625AE0D5 │ │ │ │ │ -FC43ED49F6122A43F91A374A1CD23159F9FAA6065B914D6838D1955AB69E526F │ │ │ │ │ -665F3E71587B759B12CDD0B748DD71A9F8282479F570529644B013413B5FB04C │ │ │ │ │ -9413BCD771F2118FCFAA8CC1EDDE19AB07AB64944C1AD1D12CB98682A26C8ADE │ │ │ │ │ -F84A3693B1297010FD4852FB20EB04BDA49F6840FAE8EEFA32F2A1977FC977D8 │ │ │ │ │ -A6ABAC1A9491CFC30D7C5ADC4B4AEC764D7A71309F71F03F98E5114E733ABFE5 │ │ │ │ │ -D833359A6609219685284FE61A5AA723B9BBE9F2766471F0C5B0F4494FD89ED5 │ │ │ │ │ -DFC524D87E9436CD6A8341F2314D6B1C5BB68A2D51319493F4EB6E46BD2D9A51 │ │ │ │ │ -611F2FCE7B9E5D81ABE9BB92F2737A8A812CA22DB4B29198BB1FF74BCAEBE7D3 │ │ │ │ │ -ED360D5283E35105C1C2770588EE59017969699397148466BF764AF7972EA000 │ │ │ │ │ -D9EE8202BF1736DC198D6E90E30CD137446B624472CC0D11C6516F6BF51B2DE0 │ │ │ │ │ -AD8520AF253ADF359B4A62221A6C64AE6079AC9F31B5FADBC483E6E2308DA8AE │ │ │ │ │ -6FAEEC1B9B38667FA4C9BE88A0DEDA002D188796D2D5D38C56487C5B87ECAA96 │ │ │ │ │ -F91D2EAA4089CF4FF0EC5EB7AE2EF5C6932951ED6940229030C10C6232AC513D │ │ │ │ │ -62CB78A93C2E45689F57F2433E88E8CFED3705D3D364B37D06F33E21888FC3D4 │ │ │ │ │ -2ECB515ABB9DDF938F2798AB897CDEFB68F011A3B36B58827FA0341121EE2B06 │ │ │ │ │ -31870C0AB1FED05E5A71F9E7ABB528D3522583C0730FAC9076100D22B01BC11C │ │ │ │ │ -5D87C7A1AF5B70B4F6D5BA0F9D4D45849F2012A7539D60ECACC568FF759DD94F │ │ │ │ │ -995671A839A2472821A5C784C0F7CBFCBDA870AEE0752183F40AF9F6745B4C77 │ │ │ │ │ -1B2462D646B12618BFF0495F1F77FE2B889A8FC41C939D942C2AA75698F4DE28 │ │ │ │ │ -21720C9EA6963347F36226EEC8F2E2EA58025507BCA5D14BE3B7EBC11A476243 │ │ │ │ │ -1C20AC47397556552E65418B4ABFBA36F0E18260FD4F7315146434E64D978C6A │ │ │ │ │ -DB5A8702AFEE47BA00C11EDA2EFAB79DF57A2652717A420E71A364AEC189F313 │ │ │ │ │ -80B0C4963675627F7A5805A6E833CFA0E7779633F1E789F9C0872D54AADB454F │ │ │ │ │ -EACE04D6EFC58E3420595358FE6880E580359D080E34C86946A3B120AF892736 │ │ │ │ │ -61340C1331255706F9A49AD367681C6E545D0E286439469782DA1860E5E79157 │ │ │ │ │ -39702C90686172AC1BADF76C8BEF518C9DDCABEA55F1E9F9AC45A9E7342237CA │ │ │ │ │ -D8E2C138E6599BEABF8BE2089089B1D399C1F5A30700DAD870E9E030D5AF61EB │ │ │ │ │ -B4FB98DA21D8FCC92699C2B9D5A61EF82C062B55330BDF58B115899990F3180D │ │ │ │ │ -CC9CB6416BEAD020A68CB07093AEF2ED9533BF9DE3AE1E143491C9CFBD716B24 │ │ │ │ │ -015A5B92F0D822F3E9E32ABA085B75A699E8EA328FCB5D0C3903334AFB93508F │ │ │ │ │ -CF291FE8C31DCF0E358356887F7D7F3F35C1B70AA6A7AA1BFBAF9A86CBD8804F │ │ │ │ │ -C216E01FDF281F68C7CFBC76E6F33D698A4B81365D22C6D183DDD741D8AD9474 │ │ │ │ │ -750D7DA71DEFCFFD22486509EB57068AE5ACBD4A8CDAF57A5C409A3F6AE1F171 │ │ │ │ │ -9ED8F68FFA803E1898AF1919522BC5DC6ACC9E03251E9887C7BB789E76AF416C │ │ │ │ │ -B5491FFCFEC0E6AF55E2CFDE1B1330615C67A7A17576254E001270E424164F00 │ │ │ │ │ -A31D019590161B5973BE1D8A3C668F8B9AD924CFD9E03217323FD90751D18F92 │ │ │ │ │ -E1CFF09820978843A0C8F903D2A1B87855D44164083A4988777B0BA569711878 │ │ │ │ │ -6B46BD758F8B63BE6B0605876B8E8120499840DB9DED98E0979927988152BBF1 │ │ │ │ │ -692C25A2A604CDE87413E24C1AC55A8C1A1FA5942114926980DF47BBB1905366 │ │ │ │ │ -817480A2FAF0C172EFDF2E870F2EF081ADBD117E48D765BFB69C846267CFB4E4 │ │ │ │ │ -3BE081538AD8F174009785ED0EF37A239C8004A9F6B43844EF8BEF2963CFB375 │ │ │ │ │ -249AF70D74977BE0625AED2B58F3FB01A2C7FFD40EDB5F0A25D216FF9677C633 │ │ │ │ │ -78573CA78C55A6C37851F8A5B2115C67EE87D555E4C52B2143DA7274FB0D6497 │ │ │ │ │ -881D7AA6D6D58F6098619A27EEE0D481FCE23114FB024049F380611AE683F18B │ │ │ │ │ -83653B86ADA38A22A43C707F55403C72A95672B5BB6B4532C89C82F76EAC3416 │ │ │ │ │ -72B5F42642E2E57A66833ECDCDA01D55C45CAE00FBC0F481582265F18D43EF18 │ │ │ │ │ -AD7D7595D96D225F11DD02ED7CCAC7A1FAB5256E0BE51A671151EF2EBD6C671F │ │ │ │ │ -3EA009D2923C35B4FD362E01025F5BCF763817923E373CBD3D38509AF128E6FB │ │ │ │ │ -66204C25E885AEC7B1F713A193184F554173B434768F465D51B9CB5B942C9122 │ │ │ │ │ -C23484781D86226667B9339DB44709AC33F452D7B192F17EF43BFB60ADCA6667 │ │ │ │ │ -A467A4CC4B22B1A8FF59B295799A09719CE715CD321AA0E08266A2B60C9CA9BC │ │ │ │ │ -AC914C11B4AB21C64CA416404C3F38A9C5B37F85E0FC3632CA694E893D626A57 │ │ │ │ │ -5B8A2B3F87FEDE11C49D04858E26FDA02142E637F39CA5C5B6CDF059EA95F4F5 │ │ │ │ │ -EC4206B3E05FD1856B37DDFC960FCE0A78A38E722406A5A34C5643D66667DC2E │ │ │ │ │ -6809896B01B1540BB04C9ED7E59B5A9CF98E4A8D2D6552BB3BB13B0244F3E13C │ │ │ │ │ -A23E5AF124F392EC2F129C9E70236498C1B3842D8457F87F52EA1A5309E75337 │ │ │ │ │ -8FB0117509AB4CB3AEFE8064A79725E63C8E15B28090E6D7F428C2F64F6B5A23 │ │ │ │ │ -03616D7A333A7E3EF1BBE764E8CE88506C04E106C70A0970355498C6641F3BC8 │ │ │ │ │ -FF2D7268EC30E44EAE9B6260A167AC4F972D8C67033D47305220AB24DFEEC722 │ │ │ │ │ -C1B842E246C491B7B1E09BD96639C2A72E01967D17F82FFD93A3B961BC6C91A5 │ │ │ │ │ -CDFDDFACBEAACA1552D067C3C4DD00F2EF478EF6BE3EC593D7132FC5C4368921 │ │ │ │ │ -64FD577F080185570BD8849F8055FCEC5553F440925B517E97CC5824AECB196B │ │ │ │ │ -20B8C81E463AF19C5BEE6CE540E7ACC12FE231FDBC6F1D1BC3FF69133623751A │ │ │ │ │ -79FB910B8AF7AACF27AC1A9A2FFF13736F7DE0C038A8081627FE72FC6BD0F98D │ │ │ │ │ -E909916919C66E0CDB9B9BF19134CF1BF15A638BF7122B8EC412198FB1EB797A │ │ │ │ │ -C52763F9E182D006F58F1A7AA564FF377B1A947256E887DAB1ABAAE1956F1527 │ │ │ │ │ -0E02DD3ED479FB34DB99F8F1835254DCA4C3FF981AF2162E523C4F7EE2E58DDE │ │ │ │ │ -EB016F2C3FFE0B306CA1DC4E45848891349A7DF3031E837C19698730DDF3CE17 │ │ │ │ │ -A126E2E2C7C81C9990445D11A72043D089ED310CF170714271F4F7CBC1090988 │ │ │ │ │ -83B5172F6C75EBF76E643554475547326F402330BD16FA85F8561D5F4CC89929 │ │ │ │ │ -23AF71DD0C7F6279700F11ABB7FC041110FDD62F2D44D3A7CCBDBC74DB52674E │ │ │ │ │ -0D9E4A06D6B1D9255E2448B7FB935D9A9CE5D60F1133F212C480927486E06D73 │ │ │ │ │ -5B7591D4A2836EA02F24184D858D1C59C36EDB8B7C9A58119284565F01AC749D │ │ │ │ │ -CC81F4C4ED0019FFBB34B519946C6B9A29B38FDEF7B495DA87B2AABD135FF1D0 │ │ │ │ │ -C37578AE12BB58EFC6147B14634B6EAA941AD06CABC8F038A15C4D29D83CED0F │ │ │ │ │ -B84B9D28D8F1051092F29C4ED18C6FBB1D9C45E59C5C9433A52D7C41EC7A1016 │ │ │ │ │ -EAF2D566EEB334FA1580084EF7562FBA1FAB153D9F393405E6DBAF0717BD8593 │ │ │ │ │ -087480EAD74BD4E05737F479CACF46EB2B63E47E90167AA25FBF4328C7CEF98A │ │ │ │ │ -3B8EBDA25C916DB8BE62440B3B6D565C1B65E5E4330A78499D38AC7B800083FE │ │ │ │ │ -56C5A43274E30339D0226C3F7D413AAC49A694D53DDACA2480A8ED6B93B2639A │ │ │ │ │ -DD71C459D12809622021E0CFDE12AF3E13AD7291EDA174BB0C850757F63C08EB │ │ │ │ │ -26F4178CD8D399FB17D224B8D5704632124D6D48517AE7419819C3C6E246C19C │ │ │ │ │ -2F43806FE8D7B63CE9B77BE2FEA93FA22665DF1CF4ED2A98932E1C07074E8E55 │ │ │ │ │ -AE2C8546897776CD81A3387E6B1C6FF409D2B645776E608C3DECE44E4D3D33F7 │ │ │ │ │ -893564B15AD53B4F12474BCF7D873AFC73ADBBF60E62714EF531A801E989B98C │ │ │ │ │ -81317181CFF055F6CBE741A4C90580A5C0CA05EE5EB2E5F074EC5EDE7B7CF9F3 │ │ │ │ │ -B846AFEA2ADFBE68CE9F5C5E25937939018B8B042F66A237C220D2CA77FF71F9 │ │ │ │ │ -0EA99D68B8B348AC15B7E97C6BCCE4E5B225D05A3887301F74C62D0436A1AF77 │ │ │ │ │ -AE28E0890DBF757AC062D9F486D6E5D8B50C9C4550DC02603AD7D23C7D213190 │ │ │ │ │ -55F64081A9991B89F0946C807AC2D1C54759C99A03A73DB040B0D83EF8EBB43B │ │ │ │ │ -0ABDBDFF5B8498B7A6B5F9E415280CC7A4D42D2BC4418D899044E21AC82120AC │ │ │ │ │ -834F75ADE3C01687A658F5581449D20945808E03103365959F13BFD2D279156E │ │ │ │ │ -2D2245006B6A988486E51E367AB7EF1B10EA8F910F855C8D801BB5FF6DF4D458 │ │ │ │ │ -2F786EF86738DAE9D1E0D9D3B3C4A377DF0840D1AF066E36EA4B60AC37AA08FA │ │ │ │ │ -B7D0124FCE80199D17146605765099D9F33F41ADB168F1293C93C59F7D17E3FF │ │ │ │ │ -8D3BE3D4D7D55A33ADBF9BBF94C6144EF80781FA750EDDA5D2BF8CF31E65BECE │ │ │ │ │ -F32ED9D611345843C6E5A4F99F0133736F6516333C320E463B38A37A921F085B │ │ │ │ │ -54004F78DA32B02603A0621CDF9E94AF640719F1151A14AE0EAFAAAD1FA3AFAF │ │ │ │ │ -3F596473EB719CBDB6130D7DFDFF9748C8B404355CAC4E9513D8019C64F0A201 │ │ │ │ │ -5E89FDF6D6A070D7587AF2F58B3EED5D870E4B3B8ED1AEDBA0D6597067AEBCE5 │ │ │ │ │ -94BAED6707A4A5396DE257FBE098BFA5C88DC1E3943541B7B1C87062C5797DB9 │ │ │ │ │ -47501957DF32166C36B629C989631474DF033F56D9C8BECD1B33049807702294 │ │ │ │ │ -8FE40ADF67DB14262593B5D3927A937CBAED6029F29BDD64FB6D29C60B93A9E3 │ │ │ │ │ -85796EE3A436E2D04B0DE46E9F170EF3B97151BCA2BFA5CA020E3399D9AFE147 │ │ │ │ │ -233035E4E4AEF0F7C3CEE4F4F3C18999CC2119CB4EEEAEF7E33F263D7024D733 │ │ │ │ │ -238FDBB3867EF090D3E7475C9BDDE97106D2A7E40B72A0CFE253EFE0CAA60432 │ │ │ │ │ -FB855753619AB66D54409CADA66207AE50371B98438817E0913DBAE6E9810DD8 │ │ │ │ │ -111DAA7EC3DAEED0328EC0608FD19938542952BBD78D6D609C9ED9683801EEB1 │ │ │ │ │ -098E65E47FCBBA12F75DB2E62868DBC2C800DE2555301E2856507606B6B2DB00 │ │ │ │ │ -D3020D5552B925411A2A7AF68BA4C2B77084F6343B27BE4D0C67EF6949794B00 │ │ │ │ │ -922FE8ACDB392743D7D4D38CED96EB83DAD6AF8F367F1B9223B44FCF555C3A72 │ │ │ │ │ -D013A0C5CFEBC446A4349A20410A5C497538577AEA83C18354D7F8BE9AD30687 │ │ │ │ │ -1FB911118F40D5621E8BCCBFCEC9CF32B6BB5CBDDD6D4189FEA3426B34509B5C │ │ │ │ │ -9F65A5BF6D3E4AF0A92A0D9D5690D721D74680F6840E1EDA7EE96D1B730E6F3A │ │ │ │ │ -0138A7AAD385BDED88F6B2EEE7996A3C905EB5F436E7A9C51ECBD598FD829EE1 │ │ │ │ │ -BE3D86CE94B382F11F414E8A2F8109AF87172A6FAC779EEFCF5B07DC │ │ │ │ │ +818321B3C46DB51B8EC6C2EF1D05C716519A3BD6B12A67239898F8A010C81653 │ │ │ │ │ +19A494E9F860632F8CF5B097D6F0DA0CF175BBC872BFF3D3B1CDD560A14E9301 │ │ │ │ │ +F027CB0E089F935C70F9E792F112032582E7F3BFE28ADE72E1F70D6D09021AED │ │ │ │ │ +2A703E0A93C7BC4DEE245C1D5BB30481C4C69D5A4E7B27983B969B9AD6A7BD39 │ │ │ │ │ +6A4BC688D85E1D93DA559088886D36F26570743E54EC6E94FF66F61EE8299209 │ │ │ │ │ +075CB9127C1D59FE85EE7378CE553BD80F7A03B15FB710E091902C8368DFCF73 │ │ │ │ │ +7C682089968062C005EA19B482F1982A2AD23FA4A86963A7085E40F9942C261D │ │ │ │ │ +738A72D952319A2E36DF32527E5332FE0E385152E93FDD702972A27BFBB0FDA2 │ │ │ │ │ +331A1FEA6E3DFE3E22ABD325801EF12305C84EAD056C982C9CCC7070DFE65215 │ │ │ │ │ +ECC2F84735580E99B3583D4FC68EC52E79B7F8DBA2DD43705D2E274D06BE990E │ │ │ │ │ +C58F63543A9ECF987D0C770084FF2472215A2C3D14154BCFCCB17C80CFA71B09 │ │ │ │ │ +74A07FB9EFBEE5D4F89BFA97A5B98CB409EE48D23D69463718D06FE13B7EDACB │ │ │ │ │ +EBC9F3CDB88D22F4B252DB0D9E974B4EC89CCF125FD6E32F3CBA94B9B029DBF1 │ │ │ │ │ +BD80B0C1C71C7C483914E088AF2B98C35F44620A4C694E1DFD5C96EDE0A74BB3 │ │ │ │ │ +7DDF875DBD7F2A6DA29EBFC0BDB04AE898D1B6726C1B2D2B87B45105197FC430 │ │ │ │ │ +D2D5EA628231A8C8E1A2F18F7B5F1685F5A49AE4211660B69445BF2F22F3298A │ │ │ │ │ +BF6D4BF38FBCF52B01274E36AA9BBDB1A5390CBEF9F308B2611AD6460F73248A │ │ │ │ │ +D276F94B4318D9B72F3AD4960F49DCAD17E8C298523C7C9E195D0BC9CD89671E │ │ │ │ │ +24E67D350C6A46437A4CFC29259DA49339F156F57400B2D184F52C2F1FDE6A5F │ │ │ │ │ +9D6927AEA6B6E9F4BA6A5442D1F6D8BF1783C7503631F376692F4790E6F98093 │ │ │ │ │ +F3516DD6DCF6A6615AEE983A420B396ADB0F03DD67652BA9D1A35F63A21B3EB0 │ │ │ │ │ +3021ECF9AFCB2BF7EDF9C7C515038F87485D435B6AF521453BC3CD6A05EE6F0B │ │ │ │ │ +40E141FB9633AA0A7DC51220BC4087BCF38AA5A1F5BE4333661C5F38309CAF54 │ │ │ │ │ +1A8094722C6A9E543775A76C52EC37CB7F4216BD500F71528A12F6071D402991 │ │ │ │ │ +43B828E8EF397033335DFB9D46A63093B16E23F6E735ABA1F2FC70AE7A45BF1D │ │ │ │ │ +DA09BB073D2EAEE6C3CE51FB392345343D9DC38B345734D27663738CB17B4389 │ │ │ │ │ +2E823B43CD08E02E2632F4F3632A1A29BA73F26500A3D3C73B58FBEE5B014E34 │ │ │ │ │ +C88A6D9F29B7AF28CE80810F722628D9EA8616EDAE4BFDB8B6D3105B22B48101 │ │ │ │ │ +A655B02F77BE70E024AE56D0A539E4540591EF3A2A9BE7CACF4EBC30561CA0E2 │ │ │ │ │ +ECADC8B75A67E9DAC0CD8FEFEB605B39165A63BE38C53DD7CBEFBC460D4BDA7E │ │ │ │ │ +A03C7CEA06C232A124D171C29F0BEBAD69F3420D38452EB4CD2FDB16482D7F91 │ │ │ │ │ +56026D088B9061DB7A0F865E5DE4F59F9634CEED90857A9081455D60C13E0762 │ │ │ │ │ +2064174F25C5356858B95D4B6D751086C8FB8436FE7D14ECB0A777DA75038D14 │ │ │ │ │ +D4435ADC210D91EE74912E56B6DFD38257A13706EB438316EE3708458691406A │ │ │ │ │ +4DB427EE33A580958094BDAF96FC596C12AFEF438894E1F472A0323B8C050C2A │ │ │ │ │ +38EE6A304C59862762C8E24ACAE6DCB74BEA1C974E0BDC4728DFE4EB8F12C74B │ │ │ │ │ +432E0754E95BFC82EBCE001B0D165B4D2CD3044928EC34579C5573921D217684 │ │ │ │ │ +45CA457F857A5D71218A2CB7350EB903E4410997D73119C3AF3CB54014C627AF │ │ │ │ │ +87B688A172F0EF6A553BA1B3A744C66535770891BCCEF00C010FB4FEABFEA3F2 │ │ │ │ │ +5F28188B5F41D8295097DD7994C11CE949991DE03C72150E4E2D30EB884C9643 │ │ │ │ │ +ED6017440EE0CDF19F457E74E6E2999A9F98F6DF9689292CDABBE9E6D37A4E76 │ │ │ │ │ +6A1E28B8722A1131C2303DC342F423599D6288C9DE18851A86CAD888BEBEE1D0 │ │ │ │ │ +CED4E4589A4521965F4426583BB07C32A6C41C83297E566715645AF3B46D1885 │ │ │ │ │ +6DDBC60A519346930193B3FDE32978A00844E981B2B4D89FAA5B04C9A80B1C57 │ │ │ │ │ +42DDA2461EFFCF020283F83F7A7822E7A6ADADEFD360560184B460026E5AB394 │ │ │ │ │ +0FA45B14E90C9971BD9B680000A3CE615C22C1F2EE0F03415517802266CFA515 │ │ │ │ │ +CDD6373205EE86818FAB1BD71A4EC77FCA0EE936E38D7F14165B36702E113052 │ │ │ │ │ +7C292380A7A05C17EC4136E42C0EED0C66A2837179CD18D0917FF486060C8E81 │ │ │ │ │ +61B381634235AD74C180B19484228A4A5352E885946591B73DE2C9C53A6BD0A2 │ │ │ │ │ +E2AF71B9B8B149628DD86E2CEB67DE5F37B2CC6DE80555DA903178028468DAA6 │ │ │ │ │ +22101AC889943921426433DFD9019E62EE894BA71968C6A90A4C09122CD3340B │ │ │ │ │ +3A7D33AC3DE5C66A3A255CAF9B6C94D93AD3E8AB94D16245C5E9DDD43677F3DA │ │ │ │ │ +1A4E62EFA568F65DA473F91F509CDA07BF95A338BAC5E022E9384A891A78E81F │ │ │ │ │ +377533A4338B9DCE1AD9413132552A5BBACB9DB61DD5CFB47509ACD82C12B63E │ │ │ │ │ +B3AA03FE21E7B8709F60AC273D18A70A7EFF44B05A9866478DE7565448E89FBA │ │ │ │ │ +F427C937C7371AED51E09ED03C66F94FA1356EB5F37EA9DB00C5F92B06BE33E5 │ │ │ │ │ +DDAC65A0748DE494EAB8CA4972179F1BF52FDC38CBD8E851C5040903AD80C511 │ │ │ │ │ +E52C1F2783145ED5B391899AA4BFBAFE0D887AC3349B4D66A72156A5DC6CCF7D │ │ │ │ │ +61A4D11E9DF9BE440922C7869421B711934EDFA04751D6EF9D18BA01220D4B93 │ │ │ │ │ +654CC3789F8DD146D77D25F99FD7A4F3C92BB369F64BB9358E29ADE2D3D58DB5 │ │ │ │ │ +B3A8D17ED8B6554CEB042D31F2A6D2796DA6467DA6290D5C76257F6E34768B28 │ │ │ │ │ +6907EFA4ACF8C26C94F6DCB28F2E2A524895218E7B2E7008C9AB21E2ED235705 │ │ │ │ │ +D105C1947E117716EFC8DA1C395D11153795ADEE5ECEBEAD81C1C42CF057CAC4 │ │ │ │ │ +E7D5CD71D6133D3C4CE9D04092DAEAAC7CABBCE962550743FC2AAF2C0D4710CD │ │ │ │ │ +718A2FF73E9551F31DCAADB8A536D0C470CBDAC3EB435F98292D51FEA0BDE9BE │ │ │ │ │ +7935FA4C7D8A14A7841260B37F8A736A25F23B928D906581BC153511DAF0F3A8 │ │ │ │ │ +F8885D5C98B676EA4EC1EE9502AAE0FA2E479FAACCEBCDDE20B77739C1324642 │ │ │ │ │ +8E0C6FC27A19438AD34C88189ABFA3048AC0C52B3EBF821A127296D7CBCCED39 │ │ │ │ │ +F2F64994E0A0E91730C104205B4D6E570AE25C971845DF3D06BF14C26909E037 │ │ │ │ │ +C32AF8A65EA8B174AA9EE775974B2AF16FBD628A5DEE45ED0EC170FA30818EC9 │ │ │ │ │ +92055FB2EF6CE74F16C47CE981A7FA8508290E2C6D80A6109B1163DD6E243877 │ │ │ │ │ +7DFC47110C8259D74D7A25F4434C0AF6DEC3AB5840EDA3ABF41548CA099823DE │ │ │ │ │ +CB862F57F410B2B46AB0D0DDCC38CE8DC4B4E3DD89CB9EB76D736B92ED5CFD22 │ │ │ │ │ +E0A044A1D4D658CF6D0D78AC1B3EA22B9F99C3E526411FCC027ED9C9FA20BA43 │ │ │ │ │ +FFF1447261454DC69DAFB4BF4BB04B4350429FB69393E593BF87B13CF8C41E11 │ │ │ │ │ +FF666BC3025740D85E90AE36D2096DE5C06A4EB5FAA2EB634359E39285B0BCD4 │ │ │ │ │ +B5C72A2FBB802AC723FD0734D64E5CCFF78E5D44426682A50A558761450509DA │ │ │ │ │ +AF59C121E160FB287DDC24160996B95B512004FE4A915EA91C9B86967A025CFC │ │ │ │ │ +D265A42484ED5F65BAE42A6C44B7C7B091942DD7EA56B67F71AD3A0563C3D390 │ │ │ │ │ +A26740664C9599055C380D3805FE85882AE3CE984879736DEF2B0A87B4C196B3 │ │ │ │ │ +C47BF7DBAF38FE55ED1E985A5E3CEB1AD0CB91180752BDCCCC545D49E4FC60BC │ │ │ │ │ +86A8D40135669F9AAE2AAA054795C7536CB4ECAA8A1DDA07B68F3E64BE6E2A6E │ │ │ │ │ +A4F6995DA59EABB30FAAD942ACADF03A45E212F48364AE66E4F394841D7D08D5 │ │ │ │ │ +65BAC5329E33A3D532DBAC03A768CC3FEAF79659961CDDFF0529E75827352112 │ │ │ │ │ +997B7A42C65F9B6B20ABD48C8856022B58C980AB6CED418A3B8024F00CE7B901 │ │ │ │ │ +2B34E6EB54D3F400852725DC8518418BC2EC8BA17073A01E8927C4A13EADC2BB │ │ │ │ │ +EC2BE9ACA91C011B6F91BCCFC0E461C0A709B995BCEA6D273E87DF2F866C58A2 │ │ │ │ │ +D65D1A20E26F0EF6BCB4A3C23197A8DB0562A02F4E05B8CE933AB310B97C17C2 │ │ │ │ │ +E0B8FC88E39D38D20AC69263E3F848653BF123A72F54F09D2625AAAAF2A03587 │ │ │ │ │ +4486E2DDEF87FEED6CE7B2D0982AC294E04127F2022CA7661D853ACEF0E15BA4 │ │ │ │ │ +739131D51312D8DC520C0DBE64F48F28BF1A93CEB34BDDFD20C4C7E9624163E8 │ │ │ │ │ +8D847BE474E6AE6EA286BF2FE6B3B79A59D39CFED61ACDEBAE88A46FC7F3245A │ │ │ │ │ +FD830EB9103D0CE6D523D9E536FEF5020F7436F08A98787AB8C140F7BF076893 │ │ │ │ │ +68F4F6F6A46BC8ED4EE0839E7E52B453D9CF3268CF91698AF3816666279FE67B │ │ │ │ │ +4ED48E7E5BA4F9747FCD7725CCAF6CF61C937CEDA3329BD299054CFF0D9EDA4F │ │ │ │ │ +1E837B5AB1BEE2A1DD1624B539392CE43CA511760E951A7148463DCE6C8F4E51 │ │ │ │ │ +45529B6C4AE485BF960FED002ED5F5A91BAE308E4134E0949B6B3AEE7DFF4479 │ │ │ │ │ +A4363E55AE5ED90CA5D5D3AD933834F17EB97C0EF1EC1CD12E5FC9D143064433 │ │ │ │ │ +2D4E24F4739C650A8EF87014CE07A8CAB125511A44FF320181E31166257EA8C6 │ │ │ │ │ +9805BD8E66AB7480B0B7AE666DDED24891D66AA2CD9C7320A1FF38B20B589021 │ │ │ │ │ +4AC956F1D55CE8B95A97150D2E58751C9D4B12567F484B467C4C742DC77E1D63 │ │ │ │ │ +934EE3DDE4F84CD2862DDB2C547A9E5D2E193AE82A5EEB0D2D854B6EEBB44AFA │ │ │ │ │ +6B64A7EF9D4A06D07B95DF7610E9D9FBE950DDB6F0EB15015C489E9199CE47CA │ │ │ │ │ +F8A11BC16288C91EC3B4CE9624AF13E8B02E0862ED836346D3470D709F67216D │ │ │ │ │ +FA89AFCD60C6162C3C031160077571AE70821351D6FA03B318C7DAB6A747E7BC │ │ │ │ │ +DA80F7BCA0CAECD4D7588E30CE80708ED232C7039EB5CBE41CB0650A8A3C21F8 │ │ │ │ │ +C7E6143654D4B230C630B66C762E85225E8F69F6458C85904D45C0914F3FA331 │ │ │ │ │ +37D3A21D21B09B1A8B8FAEBCF74DB7CB45D670F80F10A93ADAF29ED2B0BD2395 │ │ │ │ │ +E5755E35C36882B58BC6F04E0000CDA7EFB845B16831B7F7B660F842CCF57BFE │ │ │ │ │ +230513D4F585155ACA61DC3130EB7FA0DD38E3F7A4AE10A87565D8288634B0AF │ │ │ │ │ +E43E6FFC491A13970A0A5FBFC64EBB0B34E0C55C7A6DE2652F656C070850BBBE │ │ │ │ │ +6C9E53E91D75C1CC010FED5FA33788C3390BA1FE98FA568E6561DA1D06B0B637 │ │ │ │ │ +CB3C226A28E0F6EFAFEE574FEBC7F96979133B4F5C970E1E94962CF90BA1C28A │ │ │ │ │ +4AD14D48846592908015B96162B91B1D51845A1F39B54C0DFF1FFB00505D35E6 │ │ │ │ │ +81964E83DF03FAE64ABBAC42FC8E0D6AB572BF682A6FF7B0D90F205D1E824DD8 │ │ │ │ │ +6AB7C181B4AE6AF8B23740B45E43EC03D45F72DD8D8EA448FF2BD148818553AE │ │ │ │ │ +042BBA9FAE457A25E6D40A19F6BC43415EBBB6BD02531FA9A4A2CC7DCC053A0C │ │ │ │ │ +C31CD16EB872EEBB086859200C51B528C8BFD62968C4E6A3039653F502060A36 │ │ │ │ │ +DA25B982E9A78EA9D49DFA32D2B3DD5C1A4E5246AEFDC03B330BF377C8DAA344 │ │ │ │ │ +8D392CBFB71526A11127CD1B30FF0E1401911FF23542FF9C0C74F5443D067D54 │ │ │ │ │ +6BB073BBBA50BE9C3940C8AB058145FD8654F5B9ABB03C08431CE8A67BF52346 │ │ │ │ │ +40484EE9245625BEA5EC5D6758BF0200F48FCF48FD6E60F2B47AFF0A68058DF1 │ │ │ │ │ +85DD13D1CC884BE000C7BEF6B598AA8B87E041A4AC45109C60A72080DB6516FF │ │ │ │ │ +99B484797CA9893BBBD8256187032570393C5A3927ACD3887A3944C741E65D51 │ │ │ │ │ +1C65FF4E7D69E0F09AE91BBCC564E3D8FFF3FE2D3F61D0036D2475D0411317E2 │ │ │ │ │ +F54B13EFA3E9B8C9AF6655EC0E5E8EBD1DFF5AFBFDD30A033990D1C509AA3DDB │ │ │ │ │ +198659B0D54B08991CF6060D16A37DE53E5BC3050E62BD835A97D0FCA20E96DC │ │ │ │ │ +57325F9CB7079E9986656C1A822C24636EC3659632AAE95AC5BD9420B4FA555C │ │ │ │ │ +82467BB0264C61370DEDDB205E68D8D2E3EA7623443AA72D5464A55D9DE4E17C │ │ │ │ │ +39324526E02115DF224BCE51414D556A53FD1B97BEB57724C05BC7CE26A00E26 │ │ │ │ │ +410BE020C6EF509EB3048318E15F2A63C5475F75CCC36B50334F37F9C498DCE6 │ │ │ │ │ +7B7B205ADB698EEFF2FC663EB4BD3751EE95FA4CEAFF7F25D2EB26607C0BA573 │ │ │ │ │ +377CD322CE476B933C199DB3DF0FD770E7F6F25078E908EBD1D5AE38B57C34EC │ │ │ │ │ +46B3D11B19868D42A4DB9165F77E005F0C2780D732CB1DA5A78E3D2EF238CEF6 │ │ │ │ │ +4744F0CEBA4930289187C90BF831BBCAF0C203E6C46F8D4A9BFE73D57B3966EF │ │ │ │ │ +93ECDFEA6D54555E3EAF581DE53958BF4433E7D2270EE673B0D497C9D40CB3DF │ │ │ │ │ +02284623F4FEB3C3597EC21414F75F5CC4ABB1E93AA671E40E2C81B16A93C612 │ │ │ │ │ +F7C1D67DD7411DA7D0C50E9629D03EFBEC6F5A563EF83C6E436BAE1EA5ADC0D7 │ │ │ │ │ +4209C1E54F9A39EF576E18C4D2C81D205600C076F3AE8A2E1EC0583F593D4BFA │ │ │ │ │ +226F6F7B3BECB607727CC1AD9FA99EB23134A46CACF65A486DE4C205B28F8FB9 │ │ │ │ │ +7678022CE236EA55C9DFBCBB39270327F0821F687C37906D4D865B392529ED2A │ │ │ │ │ +C1B3642BBFEA2B4492035A6E2A4F20F1831562FBF45250EFBC84D2D3794FDF07 │ │ │ │ │ +BD14FE8ED987D4BDF21930F33711D5BF16F742D784AFA651F59604A85A873ADE │ │ │ │ │ +AF6688615691CF47A4B0C11C63819AAB923BF20BCD2C55610144685E1D4CB13D │ │ │ │ │ +4CB37A3BDE4315ED57765776958E8A2BC1D7B7AEF2D3B85BE4747F7439F474C6 │ │ │ │ │ +F54CD95392471244366A4D054B8CEFE90146B74ACA861AAABDE1B8C7E5BE124E │ │ │ │ │ +398A47ACFBE3398D7D1E43689AF857398B89478E638407C7FCFC7B3EF7EE49AA │ │ │ │ │ +F9E5A70AEFCBD034494AA998429BF358C07A4F190BF1A378EE9E9F9ED6C4D536 │ │ │ │ │ +E4CDF1ABA2B98E0188F0EE0E17CB15194541203E2AC58FA9EE42711BDF1B12BD │ │ │ │ │ +93D8CF460A7DFCA9C25FDB7D60113301626A9D26C057DC68D2C12DCE6F470584 │ │ │ │ │ +44C950D7445A2E0742B57807011849F6909D898498903CFFBB6A727D875E8640 │ │ │ │ │ +E16D08CD0C200D7D95174BC7049848FF4A4A8B9EFBEFB593F70D0A93974CFE48 │ │ │ │ │ +84E7C4E82B050E0F69D5CDAABCFAA0084A60D452ADEAA118058189C3EB9CB00A │ │ │ │ │ +977D9D83E4DF01BA01D4B6824A30882F01786E137DB078BE1BB4EA2F4E795894 │ │ │ │ │ +F369D1F59C3F2C5200DFD85F2802D8E95D98A20C53384D71D76F2CAE1CFCF9A6 │ │ │ │ │ +D51770B013AECABFA4574A00A824DA39B1DAC5508998F3B7E321C10CA83CBEAA │ │ │ │ │ +34EBAB05E4C11E0D515D980A6AA3D67D41FBB12CFF132CD044ED51C73756215F │ │ │ │ │ +5363637FABDB5E7C865C97C4A92857C87BC9B5BBB721086C8E904D22CC5F4456 │ │ │ │ │ +A421DE974B2A4BB3E9902111C9D17EA5E6F2288FEDBE6E1277A0327501C1759C │ │ │ │ │ +50C1FB32A57F72329DB9AF78053AAEAFC5A6F335A7E530EC9879A0ECCED7B3BD │ │ │ │ │ +5FC700EA1B5C0EF4B1DCDA461E291AACEC19D30F9C0906FD772E75C73DC09530 │ │ │ │ │ +B9D7AFBFFA6140C6DBC7F62552908B9435F1282FBD398422F52D7074F31996C8 │ │ │ │ │ +B151AABECAAD772209A8B45B1762322ACF059F4CA966002291A33FA2DA37AAC8 │ │ │ │ │ +1A724AD00FA70400200743E534528ECC7E4EC0DD5386DF42BB36EA4A379F4BFF │ │ │ │ │ +BF5D0489F918D675087ACA6E0ED69C34D259B0D1FD36608CB679BAACD3C4EAC2 │ │ │ │ │ +D4DF728FF9AFA2E63A283E73E737BF75F15E73B0B52B2972A32B03569A3F2290 │ │ │ │ │ +31799074A476419EED04FD6B1004068B25A713088C5B8BD4097A31399B3AED56 │ │ │ │ │ +3D9B451A6FB5020B3249E24B99531A99EFFD17BA3B2113C2219F692CB0ABC198 │ │ │ │ │ +8D49085ACB83B1605281778BBA21F38DB9ACF6F74B46863BF954542F64BA2742 │ │ │ │ │ +8D3BAF336912F551F1548D16461FC8A286E92211B211DFC69A3AA5E82E01C424 │ │ │ │ │ +08463B9FD3D011E125D5CAAD5CC546A413DF765617F02D9972632DA63554E816 │ │ │ │ │ +638B87A8358EA9E707B012A05E7DFE618525DCDC59770D96431C4C542AF0318A │ │ │ │ │ +F134BE9A4CF88CA0C83957D682862354CD55A9A020DD996F52A8995555AC0F73 │ │ │ │ │ +F3C2D3B97CD088038E1591CDD0B523480C191B321D2A8C32D91BD2F24CA803FF │ │ │ │ │ +0821BEFACE493A2C00B88D4FC2559A678F118442F7296B9B547EF4B20665F0CB │ │ │ │ │ +72CC93CBF32636335599AEA2029A3DE434A8A9D07C3F4BA4C78C4F38643D85FC │ │ │ │ │ +F19EF47539275172F17697C2BE85FF50F7B356C1B4934FC22FCE7511A6CFA54E │ │ │ │ │ +6D79109A62A63BFC2AB4718A813D6ECE4041C1EA │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ @@ -2457,21 +2437,21 @@ │ │ │ │ │ /Fd 1 43 df<000C0000001E0000001E0000001E0000001E0000001E0000601E0180781E │ │ │ │ │ 0780FC0C0FC07F0C3F803F8C7F0007CCF80001FFE000007F8000001E0000007F800001FF │ │ │ │ │ E00007CCF8003F8C7F007F0C3F80FC0C0FC0781E0780601E0180001E0000001E0000001E │ │ │ │ │ 0000001E0000001E0000000C00001A1D7C9E23>42 D E │ │ │ │ │ /Fd load 0 Fd currentfont 66.6667 scalefont put/FMat │ │ │ │ │ X/FBB X/IEn X │ │ │ │ │ %EndDVIPSBitmapFont │ │ │ │ │ -/Fe 134[51 4[38 38 38 2[49 54 81 1[51 1[27 54 49 30 43 │ │ │ │ │ -1[43 1[49 9[100 4[72 1[66 2[89 1[76 50 2[77 2[75 70 69 │ │ │ │ │ -73 9[49 2[49 1[49 49 49 1[27 1[27 44[{}33 99.6264 /CMR12 │ │ │ │ │ -rf /Ff 172[90 2[110 121 2[97 6[106 18[81 3[45 46[{}7 │ │ │ │ │ -143.462 /CMBX12 rf /Fg 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 │ │ │ │ │ +/Fe 138[54 38 38 38 2[49 54 81 1[51 1[27 54 49 30 43 │ │ │ │ │ +1[43 1[49 9[100 4[72 1[66 4[76 50 2[77 2[75 70 69 73 │ │ │ │ │ +11[49 2[49 1[49 1[27 1[27 44[{}30 99.6264 /CMR12 rf /Ff │ │ │ │ │ +172[90 2[110 121 2[97 6[106 18[81 3[45 46[{}7 143.462 │ │ │ │ │ +/CMBX12 rf /Fg 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 │ │ │ │ │ TeXDict begin │ │ │ │ │ %%BeginPaperSize: Letter │ │ │ │ │ /setpagedevice where │ │ │ │ │ { pop << /PageSize [612 792] >> setpagedevice } │ │ │ │ │ @@ -2481,17 +2461,17 @@ │ │ │ │ │ end │ │ │ │ │ %%EndSetup │ │ │ │ │ %%Page: 1 1 │ │ │ │ │ TeXDict begin 1 0 bop 590 739 a Fg(Solving)43 b(Linear)g(Systems)f │ │ │ │ │ (using)h Ff(SPOOLES)54 b(2.2)778 1005 y Fe(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 Fd(*)1664 1340 y Fe(Ma)m(y)34 b(17,)e(2024)p 0 5173 │ │ │ │ │ -1560 4 v 92 5226 a Fc(*)127 5249 y Fb(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 │ │ │ │ │ +y Fd(*)1657 1340 y Fe(June)33 b(20,)f(2025)p 0 5173 1560 │ │ │ │ │ +4 v 92 5226 a Fc(*)127 5249 y Fb(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 Fa(1)p eop end │ │ │ │ │ %%Trailer │ │ │ │ │ ├── ps2ascii {} │ │ │ │ │ │ @@ -1,8 +1,8 @@ │ │ │ │ │ │ Solving Linear Systems using SPOOLES 2.2 │ │ │ │ │ │ C. C. Ashcraft, R. G. Grimes, D. J. Pierce, D. K. Wah │ │ │ │ │ │ Boeing Phantom Works∗ │ │ │ │ │ │ - May 17, 2024 │ │ │ │ │ │ + June 20, 2025 │ │ │ │ │ │ ∗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 │ │ │ ├── ./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 2024.05.17:2217 │ │ │ │ │ +%DVIPSSource: TeX output 2025.06.20:0449 │ │ │ │ │ %%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 │ │ │ │ │ @@ -2553,22 +2553,21 @@ │ │ │ │ │ /UnderlinePosition -100 def │ │ │ │ │ /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 49 /one put │ │ │ │ │ dup 50 /two put │ │ │ │ │ -dup 52 /four put │ │ │ │ │ -dup 55 /seven put │ │ │ │ │ +dup 53 /five put │ │ │ │ │ dup 58 /colon put │ │ │ │ │ -dup 77 /M put │ │ │ │ │ -dup 97 /a put │ │ │ │ │ -dup 121 /y put │ │ │ │ │ +dup 74 /J put │ │ │ │ │ +dup 101 /e put │ │ │ │ │ +dup 110 /n put │ │ │ │ │ +dup 117 /u put │ │ │ │ │ readonly def │ │ │ │ │ currentdict end │ │ │ │ │ currentfile eexec │ │ │ │ │ D9D66F633B846AB284BCF8B0411B772DE5CE32340DC6F28AF40857E4451976E7 │ │ │ │ │ 5182433CF9F333A38BD841C0D4E68BF9E012EB32A8FFB76B5816306B5EDF7C99 │ │ │ │ │ 8B3A16D9B4BC056662E32C7CD0123DFAEB734C7532E64BBFBF5A60336E646716 │ │ │ │ │ EFB852C877F440D329172C71F1E5D59CE9473C26B8AEF7AD68EF0727B6EC2E0C │ │ │ │ │ @@ -2749,72 +2748,64 @@ │ │ │ │ │ 7CA1534C4D5B05FC33F83790ECFD7641DF3FB94289E2A1F6E7D29AB1228A867A │ │ │ │ │ 6E1EF0E9C6F899B491DC18401C2C0A05FFFED46A72C245F7529B8EA55A038082 │ │ │ │ │ 8512307217D2A233C37004085BA3AEE379269F9FA7D0ADB4B19A95CC2AFE686E │ │ │ │ │ 55D88E47257C1FE6F235FEA295910569FE6DD5995512562359CC821E85A6C7A5 │ │ │ │ │ 79B470A9E340A6985189FF8B6AF914A6B0ECF93F47903221F95DE894A8F05B05 │ │ │ │ │ B7D99CD533EC5F931B18E6B39BECF67FA2D6DD1AEC76772B068BE06335A94C05 │ │ │ │ │ 7A4DDEE77B66101DA855C17AC312600370B34E31F5EC3A01300A8EB60B4C9767 │ │ │ │ │ -1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004B9BA1CC │ │ │ │ │ -580D3C6BDA4DC1B80B4365F1C80512453FC5316EC2D928FB731C3D6403E3C18B │ │ │ │ │ -E8424D644DF5E9A2134229C5C91CA68DB8E85BA2BB40F538F585DA6FA4037718 │ │ │ │ │ -B8053EBBA1E765346BCD5BDAA6C38115D31611D8A87A2238C145F2DA2F92E4DF │ │ │ │ │ -3987BD9C4D2A3D460E8941A68B125BCD9EE4F9FD262C4C8A71F47A2C81975635 │ │ │ │ │ -F1B981C274C53FA2ACCDE4C9D0A7C62D6C1EFF91CFC6712CA6A9F333C9564FCB │ │ │ │ │ -2A70F0AD715A79B10A08AB069E2A3C93BC0AED19D0CA10134B8DDDE8AF548DB2 │ │ │ │ │ -3A4AAA9C29682CF135BB767DAA16169A127EB50A7EECEB6480CF56A7D0F8AC56 │ │ │ │ │ -4A5090B3D75A790372886AF568D94C8165975A05BFBFDF1FFBA45F70700BB9E0 │ │ │ │ │ -57F3249EF9E9C8AD9CBCF6E4FD592DC4CDD2CC7C0BC3130C1059096C657BE453 │ │ │ │ │ -A2CBACE93420210E27AF56CA229BD6D982FB68B3FDC6D44478B922C4231C47EE │ │ │ │ │ -E500232F6C11D92DEB955F66DF52B92B22E7352790CC2DCBAC53965D57AC2920 │ │ │ │ │ -68B7D520DE25047146EFEB06B9AD4E2A94243C7E5239F0BC2FC312B16051D52C │ │ │ │ │ -0B92C217B6B42997321AE4F8BB066754B7AA3F15069EF59224E8A442CE471AA7 │ │ │ │ │ -E8049A3DD9EDA09CCEE4998998661CF7DB35E952F6C65DAEB3013951C59F3E09 │ │ │ │ │ -157F313B0237876E1C0190F0473819570B8C0205AADF05D787CC00979CFB327A │ │ │ │ │ -289382B22DDA6F12804ED0ED5B179E36A995A2A59E1B66E75130DBE9109C813B │ │ │ │ │ -94403E0DEA8314A1E9DB474D7FA83C0BAFD08033E6A6215844C1D26BE15F1251 │ │ │ │ │ -A1605E8DF9A9C601ED37379530BC1C82BE5463C6C711C5652BFD6262485AA9CA │ │ │ │ │ -B8C4A117593001D08D980041E2A83C190DCE8E6CD3D334E5CC19FC05DB30F7F7 │ │ │ │ │ -24A305C4DBB31F0651392B99D44B4302333BDF7E326FD256DD75D309C6E73F85 │ │ │ │ │ -FA71B35FD1F9BEFF4C7A1076362EEB0A85492933B6006086A7B8C1928CF2D1EE │ │ │ │ │ -FD4344409257BB802C117E739960821CD3C88BFBA5669FF16F610AD638AF3677 │ │ │ │ │ -8674C985E6767253ED5769F71BEA5E9BB02A751F9E62EE2B18AC19D975FDEAE9 │ │ │ │ │ -8B8822367FF177A7E850766DE99ED3366D46464612926430012212A90F8E85F4 │ │ │ │ │ -4760B40D5B86B90819EE410382C23E86DCAF4F0FF5DFEB2C285965F4DCF2FB2B │ │ │ │ │ -457C0A0427A8D4ADA514E9DACD0F9367E1DA225DB21DA4DDAE33F2B529686D92 │ │ │ │ │ -AC085B345565F9DFFA012FD494DBB2E0B44A0787B2B72DC8D25399DAAE8864B7 │ │ │ │ │ -E84AA99DAFCEAF18F8B41882720316450F1B1CA48B418C9736E5CE4AFF996111 │ │ │ │ │ -5F7FE80958B6A3498508E9693CB134402D92E30D4C2939070D4647E13682290E │ │ │ │ │ -1D0820A3FCA7147157D09D1A40771F214EAE7DD743EA26839E535CA186C05CB8 │ │ │ │ │ -4874988AA1104D85AF0220FE7224344FF624E794BD2454E1C0AC971522FBECBA │ │ │ │ │ -B2497F25CD621B77EC5160973EF5ECC39C183DC051B0DFCB090194A2525BD96E │ │ │ │ │ -28593FDA80D8D259F039416D5F9AF0AD3C9A105B49DAF6E681921E369B7666C6 │ │ │ │ │ -2B73DB37447B00AE96317C2F1C44FB6E6EFD740BAB20FA03A8CE018EC8415582 │ │ │ │ │ -FB06E88A2971E3A480FB1EB4FE93CC7E5179721CAABEE88742B13CF0405F49F4 │ │ │ │ │ -945E587668C821D8C06D6847B6DF84CAFFCD4628670D551FC5F7236875BE1207 │ │ │ │ │ -634BA7F70A19B658FAE7D86F6D00ED28FBF29CC585DEE279325EEF8B0CCB6149 │ │ │ │ │ -E46E638C73D75148F18A636DBC2DD96ED34F68A5A09A3700B1EA34B2D142807C │ │ │ │ │ -F8709D81180783548EAE6F457BF968602076A1069163E3C15BBCEF659C6CF2E6 │ │ │ │ │ -0BB01BDC8E503802CC7969A5B8477E9788C5249B23B19669F5075E089738E49A │ │ │ │ │ -8671D7C1B1B47652F3D78BF2FF74EDB44BA5B092E8D5B85001E97F69D54AEEFC │ │ │ │ │ -88FC3CA1B0D5BAC39263B371005BCFA19AD197A31CC34D0BD55C2CA18C60C485 │ │ │ │ │ -5993F736EF1DD2C5D2B4D50B3D498861B4DF5E7AFF614BBCA4C2E6BECC0DCEF5 │ │ │ │ │ -95F0D686188014C530D8E37650CDCAE721B4AFB0F178BC744BDDDED45DAB7FEB │ │ │ │ │ -A10B975E26099E3DC61116D6BF554574F948895B88EEFE03DCC5351190836AD4 │ │ │ │ │ -EBC1AC55C6D099A8E7B0A372D290C481F44FA464B9C11A0BC991CB045E0AAAC4 │ │ │ │ │ -5C73CA43A4F17D1ADDD33D1B917FF95BFF411C8409F41553B1BC97DE47E3A1F4 │ │ │ │ │ -A5C1D1B7B1BF7E2507AC53956C141411F4F657E37981996DD7BB7ADB2CB6AE01 │ │ │ │ │ -73D0876B8F896F626D5022FE53BA34D5668BD698BE8D5CCAD083CBCEF440BE6A │ │ │ │ │ -8090EB1CDEE5F99C8988650BD4E539B357C31C597D8A9104A9D5967D4E906CAD │ │ │ │ │ -2A65575A884B1C5F6CC509E742FA9DDD66494F219178161AF72C50848E226A95 │ │ │ │ │ -A8C247FF9FF0BABD073021271B5C0692F9BE220071DAB09E5A026629371EE3C4 │ │ │ │ │ -A6E4FA94625D87A5B66EF077ED54C72B1052AEAA9637B30C76EF8EB04AD5F476 │ │ │ │ │ -D15F1C93C0BC6E0F67B366097BBED03FE82C040F9EF02866159B46854E11D44F │ │ │ │ │ -54AE6748A7E61B993A4EECD3B8BE3B5897A66BBCDFE24F65BC2AD5AB49048CF1 │ │ │ │ │ -647203823F84DF5CB483096F9D96AEE3A2855E479B72A14A67C633CE99C101CF │ │ │ │ │ -EFAE939BF9B02E710D │ │ │ │ │ +1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004ACD1870 │ │ │ │ │ +A5EA947858F5795870BFE1343AD803FB854BF8F5A4E794E8EC57BE41DB5B8734 │ │ │ │ │ +13E47950F29A81EA0C81EA798863883D7F41F78325CA190CBBFFE822AE494550 │ │ │ │ │ +4BE83703071FC9512D128927AF3F63CEF8F86ABE1E15D7B4DDD39576E7DFF45E │ │ │ │ │ +3CB4115AAB1830DE8647B915DB4BEBEB5235C281E098B899BAB951D8D5798F01 │ │ │ │ │ +7F7C47336D31438E5126738AFEAB29E9A7CBE06DE4DD604477B542D2620DFD58 │ │ │ │ │ +28FE34238572F23C5A8EB7ACEE1E154DA13FC1A5AA67A3BA8C5CDFB2B80312C9 │ │ │ │ │ +BC9FAE56D08DDFA9498E6EF0D0F6BD18B3923E0B670B0740528BC843610736CB │ │ │ │ │ +80228C105C2F72C3C22D610C3D8C268DEEA2AEEE3221E198E79FE2966487360C │ │ │ │ │ +84AE08AC326F48B21447652121B1EB68AF856055EEA65B6B625BF622CBFC2D1C │ │ │ │ │ +EF943CC4CAF2C715782C9EF9A9BA4689BFC6B6A82F8D55795BE8111E2C7DE520 │ │ │ │ │ +367362304B6A48186C842033E715A46265A352472F4F7313248EBCD26BEA97E7 │ │ │ │ │ +B814A61D4B7ADCB5C5F21AA34E0C1269E8426DBFB511DE6E26B960456C8F8520 │ │ │ │ │ +5F0DD382289A62AF0B935EDB5B2394538C5F0EE72962D2F98F3C38CD7C027B9F │ │ │ │ │ +E230E67E40FEFBDED06B3423C9DFD669E6B5BC913E0FF75786A64A6C11D4FE89 │ │ │ │ │ +1B918DC0E953C52CFD153063CD0D2A78B43F8712243845E6F2CBA1DB610F403D │ │ │ │ │ +A98D06D95FF44C7AC029092B666A8B0DCEA95B34F5ACC10E8611BADE6A24469C │ │ │ │ │ +0C01D95BFB445FA22CD38D033E4D24E006BB9D54EE41EF7AD5AC9C299721F61A │ │ │ │ │ +F01B6EDCDF428BD9195A13C5B1027358F8A203F828A1DD9622243B2D76C6F1BA │ │ │ │ │ +9F2D7E9D4879FC668ABC750CD25415DC6CCF2257C28F78D3F9BE499CC0FF2F80 │ │ │ │ │ +2C2CD1DEFABD6668FCA76E1D629A344333E33DA24B86D2E9F8F5EE1C29974640 │ │ │ │ │ +C3E78E999BAB313400041DADDDFDBFFCC419F129A84F4D412B79E8BE4511CA00 │ │ │ │ │ +F92A4F3CDD2E51345D3965C104F06B6503445DC20224CB7606A9D7D5F9EE45E6 │ │ │ │ │ +1B2963DA96AA2AB1BA5BE29656E666E4D0E122DE58EEA68E04ED76438DA03E65 │ │ │ │ │ +B80055A86B7B2A26BAE6BBB8835E17F9696E9B3CD34571BA75C76D4D2CCC48F1 │ │ │ │ │ +7534C1EF9127E374D65D05B8072E08D6C72A0B4A35EA0DD717743C66D105CCD8 │ │ │ │ │ +7355F13E9C38C1A4351624E689ED7909100942FA0474842EE44DEC3279E1A1CD │ │ │ │ │ +8064666EB845CA7C3E906B67C0BF96A28D514DB2E4A1E4AF287350B03762A2CF │ │ │ │ │ +13B18AC3F5D2F3B74A1D50267C03EFB74B888E1D24ABEEA4A885F4D0BF14C0D8 │ │ │ │ │ +289AC79D6D98E2A2C831672FB1F3457564CD161ADC3AF610D88201AB5B0C10CB │ │ │ │ │ +5ECCC2D5C4AF39C8CB3044BF9EC791BA45D29C2B51EA0483D19822C264CE6FA3 │ │ │ │ │ +5C97F2DF5A78CB93528E99B9ED7CB121C83130C129B849B52A36EBD88AF19DD3 │ │ │ │ │ +C5CABE831027388EF86BD5CBD90AAAC089775938A321C44D4DDA67A51312D8AB │ │ │ │ │ +C509DDBE7044A107AB2BE9C4C9556F85C529B174A7778B489BF28EC07A834542 │ │ │ │ │ +8B31F2925C21FB2096877711F998763D5A8495002B8E080AF8DBB1B3106EDDBA │ │ │ │ │ +35121D52E0846A7AF3ABEDF87BDE4FA665673A9B80CA538B98F873947AA17EF4 │ │ │ │ │ +9BB182917E9D79BC7EC681E93710D6A1D6B0E4A7FA9452FC1C431808174F3AB7 │ │ │ │ │ +F3914FBC86CB34E8583457243C3C7BE4BC166C7397689BC6FFB82EA2967E88EE │ │ │ │ │ +464F96EDA144DE2B64401B8E577ABCA2D826FE0B92E21FFAE3E81EBB6B6EB36E │ │ │ │ │ +9B1A8FE3884CA398C03135FD49D51724FC1268E9482E41FAEA2FC6C809006B8F │ │ │ │ │ +5D4F9E038450AD3A6041C16FD1C7E5FC80C0E033CE57E64863E014531D94DF1E │ │ │ │ │ +31D7D038AFCB60715AA73C1E96F113A24C5AF35BBEB61C4D079ED034ED83AA4A │ │ │ │ │ +E12448E618330463304788BCF40561CD63167B3BF144F408E2B89E60B8BA13EF │ │ │ │ │ +3B57D286FD23D4FA8BAEFF98DC1188B1982956CC1DCAEFC7D949B7B4E3BE8F8A │ │ │ │ │ +BFE2C9D938DD13EFEE7123576608D9396F260907DA98AE2D3DD5822306CBC8A6 │ │ │ │ │ +B083C697DDA3C62EE7879436A9FD8EE0034B105105B3F122F893EA2126EBE8A9 │ │ │ │ │ +5CBF2BD248DD9FBEF0040C25797BD13B69A8C9F0D4E4F935C61ED30487CCDB1A │ │ │ │ │ +0339006E78EE1755929D2412776EC7DB1F666DBDD28EA8AC7397F809C7F38A41 │ │ │ │ │ +5B3BF6C75F4F35C90141EB08377AF452CF840FEA938805F9D14E02DC29215B4E │ │ │ │ │ +F1EB │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ @@ -4104,15 +4095,15 @@ │ │ │ │ │ 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 23[45 19[83 18[25 2[45 2[45 1[45 45 45 3[25 44[{}10 │ │ │ │ │ +138[51 6[51 8[40 26[47 15[25 4[45 2[45 1[45 3[25 44[{}9 │ │ │ │ │ 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 │ │ │ │ │ @@ -4222,17 +4213,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 1232 4 v │ │ │ │ │ -1414 w Fk(BKL)29 b Fh(:)i Fg(DRAFT)f Fh(Ma)m(y)h(17,)h(2024)p │ │ │ │ │ -2669 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 1225 4 v │ │ │ │ │ +1407 w Fk(BKL)29 b Fh(:)i Fg(DRAFT)f Fh(June)f(20,)j(2025)p │ │ │ │ │ +2676 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 │ │ │ │ │ @@ -4277,17 +4268,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 1232 4 v 1413 100 a Fk(BKL)30 │ │ │ │ │ -b Fh(:)g Fg(DRAFT)121 b Fh(Ma)m(y)32 b(17,)f(2024)p 2621 │ │ │ │ │ -100 V 1232 w Fl(3)0 399 y Fe(1.3.1)112 b(Initializer)38 │ │ │ │ │ +TeXDict begin 3 2 bop 91 100 1225 4 v 1406 100 a Fk(BKL)30 │ │ │ │ │ +b Fh(:)g Fg(DRAFT)121 b Fh(June)30 b(20,)h(2025)p 2628 │ │ │ │ │ +100 V 1225 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 │ │ │ │ │ @@ -4351,17 +4342,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 1232 4 v │ │ │ │ │ -1414 w Fk(BKL)29 b Fh(:)i Fg(DRAFT)f Fh(Ma)m(y)h(17,)h(2024)p │ │ │ │ │ -2669 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 1225 4 v │ │ │ │ │ +1407 w Fk(BKL)29 b Fh(:)i Fg(DRAFT)f Fh(June)f(20,)j(2025)p │ │ │ │ │ +2676 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 │ │ │ │ │ @@ -4429,17 +4420,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 1232 4 v 1413 100 a Fk(BKL)30 │ │ │ │ │ -b Fh(:)g Fg(DRAFT)121 b Fh(Ma)m(y)32 b(17,)f(2024)p 2621 │ │ │ │ │ -100 V 1232 w Fl(5)111 399 y(3.)46 b Fk(float)h(BKL_eval)e(\()j(BKL)f │ │ │ │ │ +TeXDict begin 5 4 bop 91 100 1225 4 v 1406 100 a Fk(BKL)30 │ │ │ │ │ +b Fh(:)g Fg(DRAFT)121 b Fh(June)30 b(20,)h(2025)p 2628 │ │ │ │ │ +100 V 1225 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 May 17, 2024 │ │ │ │ │ │ + 2 BKL : DRAFT June 20, 2025 │ │ │ │ │ │ • 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 May 17, 2024 3 │ │ │ │ │ │ + BKL : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 4 BKL : DRAFT June 20, 2025 │ │ │ │ │ │ • 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 May 17, 2024 5 │ │ │ │ │ │ + BKL : DRAFT June 20, 2025 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 2024.05.17:2217 │ │ │ │ │ +%DVIPSSource: TeX output 2025.06.20:0449 │ │ │ │ │ %%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 │ │ │ │ │ @@ -1425,22 +1425,21 @@ │ │ │ │ │ /UnderlinePosition -100 def │ │ │ │ │ /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 49 /one put │ │ │ │ │ dup 50 /two put │ │ │ │ │ -dup 52 /four put │ │ │ │ │ -dup 55 /seven put │ │ │ │ │ +dup 53 /five put │ │ │ │ │ dup 58 /colon put │ │ │ │ │ -dup 77 /M put │ │ │ │ │ -dup 97 /a put │ │ │ │ │ -dup 121 /y put │ │ │ │ │ +dup 74 /J put │ │ │ │ │ +dup 101 /e put │ │ │ │ │ +dup 110 /n put │ │ │ │ │ +dup 117 /u put │ │ │ │ │ readonly def │ │ │ │ │ currentdict end │ │ │ │ │ currentfile eexec │ │ │ │ │ D9D66F633B846AB284BCF8B0411B772DE5CE32340DC6F28AF40857E4451976E7 │ │ │ │ │ 5182433CF9F333A38BD841C0D4E68BF9E012EB32A8FFB76B5816306B5EDF7C99 │ │ │ │ │ 8B3A16D9B4BC056662E32C7CD0123DFAEB734C7532E64BBFBF5A60336E646716 │ │ │ │ │ EFB852C877F440D329172C71F1E5D59CE9473C26B8AEF7AD68EF0727B6EC2E0C │ │ │ │ │ @@ -1621,72 +1620,64 @@ │ │ │ │ │ 7CA1534C4D5B05FC33F83790ECFD7641DF3FB94289E2A1F6E7D29AB1228A867A │ │ │ │ │ 6E1EF0E9C6F899B491DC18401C2C0A05FFFED46A72C245F7529B8EA55A038082 │ │ │ │ │ 8512307217D2A233C37004085BA3AEE379269F9FA7D0ADB4B19A95CC2AFE686E │ │ │ │ │ 55D88E47257C1FE6F235FEA295910569FE6DD5995512562359CC821E85A6C7A5 │ │ │ │ │ 79B470A9E340A6985189FF8B6AF914A6B0ECF93F47903221F95DE894A8F05B05 │ │ │ │ │ B7D99CD533EC5F931B18E6B39BECF67FA2D6DD1AEC76772B068BE06335A94C05 │ │ │ │ │ 7A4DDEE77B66101DA855C17AC312600370B34E31F5EC3A01300A8EB60B4C9767 │ │ │ │ │ -1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004B9BA1CC │ │ │ │ │ -580D3C6BDA4DC1B80B4365F1C80512453FC5316EC2D928FB731C3D6403E3C18B │ │ │ │ │ -E8424D644DF5E9A2134229C5C91CA68DB8E85BA2BB40F538F585DA6FA4037718 │ │ │ │ │ -B8053EBBA1E765346BCD5BDAA6C38115D31611D8A87A2238C145F2DA2F92E4DF │ │ │ │ │ -3987BD9C4D2A3D460E8941A68B125BCD9EE4F9FD262C4C8A71F47A2C81975635 │ │ │ │ │ -F1B981C274C53FA2ACCDE4C9D0A7C62D6C1EFF91CFC6712CA6A9F333C9564FCB │ │ │ │ │ -2A70F0AD715A79B10A08AB069E2A3C93BC0AED19D0CA10134B8DDDE8AF548DB2 │ │ │ │ │ -3A4AAA9C29682CF135BB767DAA16169A127EB50A7EECEB6480CF56A7D0F8AC56 │ │ │ │ │ -4A5090B3D75A790372886AF568D94C8165975A05BFBFDF1FFBA45F70700BB9E0 │ │ │ │ │ -57F3249EF9E9C8AD9CBCF6E4FD592DC4CDD2CC7C0BC3130C1059096C657BE453 │ │ │ │ │ -A2CBACE93420210E27AF56CA229BD6D982FB68B3FDC6D44478B922C4231C47EE │ │ │ │ │ -E500232F6C11D92DEB955F66DF52B92B22E7352790CC2DCBAC53965D57AC2920 │ │ │ │ │ -68B7D520DE25047146EFEB06B9AD4E2A94243C7E5239F0BC2FC312B16051D52C │ │ │ │ │ -0B92C217B6B42997321AE4F8BB066754B7AA3F15069EF59224E8A442CE471AA7 │ │ │ │ │ -E8049A3DD9EDA09CCEE4998998661CF7DB35E952F6C65DAEB3013951C59F3E09 │ │ │ │ │ -157F313B0237876E1C0190F0473819570B8C0205AADF05D787CC00979CFB327A │ │ │ │ │ -289382B22DDA6F12804ED0ED5B179E36A995A2A59E1B66E75130DBE9109C813B │ │ │ │ │ -94403E0DEA8314A1E9DB474D7FA83C0BAFD08033E6A6215844C1D26BE15F1251 │ │ │ │ │ -A1605E8DF9A9C601ED37379530BC1C82BE5463C6C711C5652BFD6262485AA9CA │ │ │ │ │ -B8C4A117593001D08D980041E2A83C190DCE8E6CD3D334E5CC19FC05DB30F7F7 │ │ │ │ │ -24A305C4DBB31F0651392B99D44B4302333BDF7E326FD256DD75D309C6E73F85 │ │ │ │ │ -FA71B35FD1F9BEFF4C7A1076362EEB0A85492933B6006086A7B8C1928CF2D1EE │ │ │ │ │ -FD4344409257BB802C117E739960821CD3C88BFBA5669FF16F610AD638AF3677 │ │ │ │ │ -8674C985E6767253ED5769F71BEA5E9BB02A751F9E62EE2B18AC19D975FDEAE9 │ │ │ │ │ -8B8822367FF177A7E850766DE99ED3366D46464612926430012212A90F8E85F4 │ │ │ │ │ -4760B40D5B86B90819EE410382C23E86DCAF4F0FF5DFEB2C285965F4DCF2FB2B │ │ │ │ │ -457C0A0427A8D4ADA514E9DACD0F9367E1DA225DB21DA4DDAE33F2B529686D92 │ │ │ │ │ -AC085B345565F9DFFA012FD494DBB2E0B44A0787B2B72DC8D25399DAAE8864B7 │ │ │ │ │ -E84AA99DAFCEAF18F8B41882720316450F1B1CA48B418C9736E5CE4AFF996111 │ │ │ │ │ -5F7FE80958B6A3498508E9693CB134402D92E30D4C2939070D4647E13682290E │ │ │ │ │ -1D0820A3FCA7147157D09D1A40771F214EAE7DD743EA26839E535CA186C05CB8 │ │ │ │ │ -4874988AA1104D85AF0220FE7224344FF624E794BD2454E1C0AC971522FBECBA │ │ │ │ │ -B2497F25CD621B77EC5160973EF5ECC39C183DC051B0DFCB090194A2525BD96E │ │ │ │ │ -28593FDA80D8D259F039416D5F9AF0AD3C9A105B49DAF6E681921E369B7666C6 │ │ │ │ │ -2B73DB37447B00AE96317C2F1C44FB6E6EFD740BAB20FA03A8CE018EC8415582 │ │ │ │ │ -FB06E88A2971E3A480FB1EB4FE93CC7E5179721CAABEE88742B13CF0405F49F4 │ │ │ │ │ -945E587668C821D8C06D6847B6DF84CAFFCD4628670D551FC5F7236875BE1207 │ │ │ │ │ -634BA7F70A19B658FAE7D86F6D00ED28FBF29CC585DEE279325EEF8B0CCB6149 │ │ │ │ │ -E46E638C73D75148F18A636DBC2DD96ED34F68A5A09A3700B1EA34B2D142807C │ │ │ │ │ -F8709D81180783548EAE6F457BF968602076A1069163E3C15BBCEF659C6CF2E6 │ │ │ │ │ -0BB01BDC8E503802CC7969A5B8477E9788C5249B23B19669F5075E089738E49A │ │ │ │ │ -8671D7C1B1B47652F3D78BF2FF74EDB44BA5B092E8D5B85001E97F69D54AEEFC │ │ │ │ │ -88FC3CA1B0D5BAC39263B371005BCFA19AD197A31CC34D0BD55C2CA18C60C485 │ │ │ │ │ -5993F736EF1DD2C5D2B4D50B3D498861B4DF5E7AFF614BBCA4C2E6BECC0DCEF5 │ │ │ │ │ -95F0D686188014C530D8E37650CDCAE721B4AFB0F178BC744BDDDED45DAB7FEB │ │ │ │ │ -A10B975E26099E3DC61116D6BF554574F948895B88EEFE03DCC5351190836AD4 │ │ │ │ │ -EBC1AC55C6D099A8E7B0A372D290C481F44FA464B9C11A0BC991CB045E0AAAC4 │ │ │ │ │ -5C73CA43A4F17D1ADDD33D1B917FF95BFF411C8409F41553B1BC97DE47E3A1F4 │ │ │ │ │ -A5C1D1B7B1BF7E2507AC53956C141411F4F657E37981996DD7BB7ADB2CB6AE01 │ │ │ │ │ -73D0876B8F896F626D5022FE53BA34D5668BD698BE8D5CCAD083CBCEF440BE6A │ │ │ │ │ -8090EB1CDEE5F99C8988650BD4E539B357C31C597D8A9104A9D5967D4E906CAD │ │ │ │ │ -2A65575A884B1C5F6CC509E742FA9DDD66494F219178161AF72C50848E226A95 │ │ │ │ │ -A8C247FF9FF0BABD073021271B5C0692F9BE220071DAB09E5A026629371EE3C4 │ │ │ │ │ -A6E4FA94625D87A5B66EF077ED54C72B1052AEAA9637B30C76EF8EB04AD5F476 │ │ │ │ │ -D15F1C93C0BC6E0F67B366097BBED03FE82C040F9EF02866159B46854E11D44F │ │ │ │ │ -54AE6748A7E61B993A4EECD3B8BE3B5897A66BBCDFE24F65BC2AD5AB49048CF1 │ │ │ │ │ -647203823F84DF5CB483096F9D96AEE3A2855E479B72A14A67C633CE99C101CF │ │ │ │ │ -EFAE939BF9B02E710D │ │ │ │ │ +1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004ACD1870 │ │ │ │ │ +A5EA947858F5795870BFE1343AD803FB854BF8F5A4E794E8EC57BE41DB5B8734 │ │ │ │ │ +13E47950F29A81EA0C81EA798863883D7F41F78325CA190CBBFFE822AE494550 │ │ │ │ │ +4BE83703071FC9512D128927AF3F63CEF8F86ABE1E15D7B4DDD39576E7DFF45E │ │ │ │ │ +3CB4115AAB1830DE8647B915DB4BEBEB5235C281E098B899BAB951D8D5798F01 │ │ │ │ │ +7F7C47336D31438E5126738AFEAB29E9A7CBE06DE4DD604477B542D2620DFD58 │ │ │ │ │ +28FE34238572F23C5A8EB7ACEE1E154DA13FC1A5AA67A3BA8C5CDFB2B80312C9 │ │ │ │ │ +BC9FAE56D08DDFA9498E6EF0D0F6BD18B3923E0B670B0740528BC843610736CB │ │ │ │ │ +80228C105C2F72C3C22D610C3D8C268DEEA2AEEE3221E198E79FE2966487360C │ │ │ │ │ +84AE08AC326F48B21447652121B1EB68AF856055EEA65B6B625BF622CBFC2D1C │ │ │ │ │ +EF943CC4CAF2C715782C9EF9A9BA4689BFC6B6A82F8D55795BE8111E2C7DE520 │ │ │ │ │ +367362304B6A48186C842033E715A46265A352472F4F7313248EBCD26BEA97E7 │ │ │ │ │ +B814A61D4B7ADCB5C5F21AA34E0C1269E8426DBFB511DE6E26B960456C8F8520 │ │ │ │ │ +5F0DD382289A62AF0B935EDB5B2394538C5F0EE72962D2F98F3C38CD7C027B9F │ │ │ │ │ +E230E67E40FEFBDED06B3423C9DFD669E6B5BC913E0FF75786A64A6C11D4FE89 │ │ │ │ │ +1B918DC0E953C52CFD153063CD0D2A78B43F8712243845E6F2CBA1DB610F403D │ │ │ │ │ +A98D06D95FF44C7AC029092B666A8B0DCEA95B34F5ACC10E8611BADE6A24469C │ │ │ │ │ +0C01D95BFB445FA22CD38D033E4D24E006BB9D54EE41EF7AD5AC9C299721F61A │ │ │ │ │ +F01B6EDCDF428BD9195A13C5B1027358F8A203F828A1DD9622243B2D76C6F1BA │ │ │ │ │ +9F2D7E9D4879FC668ABC750CD25415DC6CCF2257C28F78D3F9BE499CC0FF2F80 │ │ │ │ │ +2C2CD1DEFABD6668FCA76E1D629A344333E33DA24B86D2E9F8F5EE1C29974640 │ │ │ │ │ +C3E78E999BAB313400041DADDDFDBFFCC419F129A84F4D412B79E8BE4511CA00 │ │ │ │ │ +F92A4F3CDD2E51345D3965C104F06B6503445DC20224CB7606A9D7D5F9EE45E6 │ │ │ │ │ +1B2963DA96AA2AB1BA5BE29656E666E4D0E122DE58EEA68E04ED76438DA03E65 │ │ │ │ │ +B80055A86B7B2A26BAE6BBB8835E17F9696E9B3CD34571BA75C76D4D2CCC48F1 │ │ │ │ │ +7534C1EF9127E374D65D05B8072E08D6C72A0B4A35EA0DD717743C66D105CCD8 │ │ │ │ │ +7355F13E9C38C1A4351624E689ED7909100942FA0474842EE44DEC3279E1A1CD │ │ │ │ │ +8064666EB845CA7C3E906B67C0BF96A28D514DB2E4A1E4AF287350B03762A2CF │ │ │ │ │ +13B18AC3F5D2F3B74A1D50267C03EFB74B888E1D24ABEEA4A885F4D0BF14C0D8 │ │ │ │ │ +289AC79D6D98E2A2C831672FB1F3457564CD161ADC3AF610D88201AB5B0C10CB │ │ │ │ │ +5ECCC2D5C4AF39C8CB3044BF9EC791BA45D29C2B51EA0483D19822C264CE6FA3 │ │ │ │ │ +5C97F2DF5A78CB93528E99B9ED7CB121C83130C129B849B52A36EBD88AF19DD3 │ │ │ │ │ +C5CABE831027388EF86BD5CBD90AAAC089775938A321C44D4DDA67A51312D8AB │ │ │ │ │ +C509DDBE7044A107AB2BE9C4C9556F85C529B174A7778B489BF28EC07A834542 │ │ │ │ │ +8B31F2925C21FB2096877711F998763D5A8495002B8E080AF8DBB1B3106EDDBA │ │ │ │ │ +35121D52E0846A7AF3ABEDF87BDE4FA665673A9B80CA538B98F873947AA17EF4 │ │ │ │ │ +9BB182917E9D79BC7EC681E93710D6A1D6B0E4A7FA9452FC1C431808174F3AB7 │ │ │ │ │ +F3914FBC86CB34E8583457243C3C7BE4BC166C7397689BC6FFB82EA2967E88EE │ │ │ │ │ +464F96EDA144DE2B64401B8E577ABCA2D826FE0B92E21FFAE3E81EBB6B6EB36E │ │ │ │ │ +9B1A8FE3884CA398C03135FD49D51724FC1268E9482E41FAEA2FC6C809006B8F │ │ │ │ │ +5D4F9E038450AD3A6041C16FD1C7E5FC80C0E033CE57E64863E014531D94DF1E │ │ │ │ │ +31D7D038AFCB60715AA73C1E96F113A24C5AF35BBEB61C4D079ED034ED83AA4A │ │ │ │ │ +E12448E618330463304788BCF40561CD63167B3BF144F408E2B89E60B8BA13EF │ │ │ │ │ +3B57D286FD23D4FA8BAEFF98DC1188B1982956CC1DCAEFC7D949B7B4E3BE8F8A │ │ │ │ │ +BFE2C9D938DD13EFEE7123576608D9396F260907DA98AE2D3DD5822306CBC8A6 │ │ │ │ │ +B083C697DDA3C62EE7879436A9FD8EE0034B105105B3F122F893EA2126EBE8A9 │ │ │ │ │ +5CBF2BD248DD9FBEF0040C25797BD13B69A8C9F0D4E4F935C61ED30487CCDB1A │ │ │ │ │ +0339006E78EE1755929D2412776EC7DB1F666DBDD28EA8AC7397F809C7F38A41 │ │ │ │ │ +5B3BF6C75F4F35C90141EB08377AF452CF840FEA938805F9D14E02DC29215B4E │ │ │ │ │ +F1EB │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ @@ -4730,16 +4721,16 @@ │ │ │ │ │ @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 23[42 19[76 18[23 │ │ │ │ │ -2[42 2[42 1[42 42 42 3[23 44[{}10 83.022 /CMSL10 rf /Ff │ │ │ │ │ +46[{}27 119.552 /CMBX12 rf /Fe 138[46 6[46 8[37 26[43 │ │ │ │ │ +15[23 4[42 2[42 1[42 3[23 44[{}9 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 │ │ │ │ │ @@ -4888,17 +4879,17 @@ │ │ │ │ │ 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 1294 4 v │ │ │ │ │ -1459 w Fl(BPG)27 b Fe(:)g Fk(DRAFT)h Fe(Ma)n(y)e(17,)h(2024)p │ │ │ │ │ -2606 100 V 125 390 a Fh(\210)42 b Fm(Drop)27 b(an)g(alternating)g(lev)n │ │ │ │ │ +TeXDict begin 2 1 bop 0 100 a Fm(2)p 125 100 1288 4 v │ │ │ │ │ +1453 w Fl(BPG)26 b Fe(:)i Fk(DRAFT)f Fe(June)h(20,)f(2025)p │ │ │ │ │ +2613 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 │ │ │ │ │ @@ -5018,17 +5009,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 1294 4 v 1460 100 a Fl(BPG)26 │ │ │ │ │ -b Fe(:)i Fk(DRAFT)110 b Fe(Ma)n(y)27 b(17,)g(2024)p 2567 │ │ │ │ │ -100 V 1294 w Fm(3)0 390 y(la)n(y)n(ers)e(to)i(the)g(wide)g(separator,)e │ │ │ │ │ +TeXDict begin 3 2 bop 83 100 1288 4 v 1453 100 a Fl(BPG)27 │ │ │ │ │ +b Fe(:)h Fk(DRAFT)110 b Fe(June)27 b(20,)g(2025)p 2573 │ │ │ │ │ +100 V 1288 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 │ │ │ │ │ @@ -5089,17 +5080,17 @@ │ │ │ │ │ 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 1294 4 v │ │ │ │ │ -1459 w Fl(BPG)27 b Fe(:)g Fk(DRAFT)h Fe(Ma)n(y)e(17,)h(2024)p │ │ │ │ │ -2606 100 V 0 390 a Fb(1.2.2)112 b(Initializer)38 b(metho)s(ds)0 │ │ │ │ │ +TeXDict begin 4 3 bop 0 100 a Fm(4)p 125 100 1288 4 v │ │ │ │ │ +1453 w Fl(BPG)26 b Fe(:)i Fk(DRAFT)f Fe(June)h(20,)f(2025)p │ │ │ │ │ +2613 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 │ │ │ │ │ @@ -5183,17 +5174,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 1294 4 v 1460 100 a Fl(BPG)26 │ │ │ │ │ -b Fe(:)i Fk(DRAFT)110 b Fe(Ma)n(y)27 b(17,)g(2024)p 2567 │ │ │ │ │ -100 V 1294 w Fm(5)0 390 y Fb(1.2.5)112 b(Dulmage-Mendelsohn)42 │ │ │ │ │ +TeXDict begin 5 4 bop 83 100 1288 4 v 1453 100 a Fl(BPG)27 │ │ │ │ │ +b Fe(:)h Fk(DRAFT)110 b Fe(June)27 b(20,)g(2025)p 2573 │ │ │ │ │ +100 V 1288 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 │ │ │ │ │ @@ -5288,17 +5279,17 @@ │ │ │ │ │ 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 1294 4 v │ │ │ │ │ -1459 w Fl(BPG)27 b Fe(:)g Fk(DRAFT)h Fe(Ma)n(y)e(17,)h(2024)p │ │ │ │ │ -2606 100 V 101 390 a Fm(3.)42 b Fl(int)g(BPG_readFromBina)o(ry)o(Fil)o │ │ │ │ │ +TeXDict begin 6 5 bop 0 100 a Fm(6)p 125 100 1288 4 v │ │ │ │ │ +1453 w Fl(BPG)26 b Fe(:)i Fk(DRAFT)f Fe(June)h(20,)f(2025)p │ │ │ │ │ +2613 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 │ │ │ │ │ @@ -5381,17 +5372,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 1294 4 v 1460 100 a Fl(BPG)26 │ │ │ │ │ -b Fe(:)i Fk(DRAFT)110 b Fe(Ma)n(y)27 b(17,)g(2024)p 2567 │ │ │ │ │ -100 V 1294 w Fm(7)307 390 y Fh(\210)42 b Fm(The)33 b │ │ │ │ │ +TeXDict begin 7 6 bop 83 100 1288 4 v 1453 100 a Fl(BPG)27 │ │ │ │ │ +b Fe(:)h Fk(DRAFT)110 b Fe(June)27 b(20,)g(2025)p 2573 │ │ │ │ │ +100 V 1288 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 May 17, 2024 │ │ │ │ │ │ + 2 BPG : DRAFT June 20, 2025 │ │ │ │ │ │ • 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 May 17, 2024 3 │ │ │ │ │ │ + BPG : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 4 BPG : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 5 │ │ │ │ │ │ + BPG : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 6 BPG : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 7 │ │ │ │ │ │ + BPG : DRAFT June 20, 2025 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 2024.05.17:2217 │ │ │ │ │ +%DVIPSSource: TeX output 2025.06.20:0449 │ │ │ │ │ %%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 │ │ │ │ │ @@ -2516,22 +2516,21 @@ │ │ │ │ │ /UnderlinePosition -100 def │ │ │ │ │ /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 49 /one put │ │ │ │ │ dup 50 /two put │ │ │ │ │ -dup 52 /four put │ │ │ │ │ -dup 55 /seven put │ │ │ │ │ +dup 53 /five put │ │ │ │ │ dup 58 /colon put │ │ │ │ │ -dup 77 /M put │ │ │ │ │ -dup 97 /a put │ │ │ │ │ -dup 121 /y put │ │ │ │ │ +dup 74 /J put │ │ │ │ │ +dup 101 /e put │ │ │ │ │ +dup 110 /n put │ │ │ │ │ +dup 117 /u put │ │ │ │ │ readonly def │ │ │ │ │ currentdict end │ │ │ │ │ currentfile eexec │ │ │ │ │ D9D66F633B846AB284BCF8B0411B772DE5CE32340DC6F28AF40857E4451976E7 │ │ │ │ │ 5182433CF9F333A38BD841C0D4E68BF9E012EB32A8FFB76B5816306B5EDF7C99 │ │ │ │ │ 8B3A16D9B4BC056662E32C7CD0123DFAEB734C7532E64BBFBF5A60336E646716 │ │ │ │ │ EFB852C877F440D329172C71F1E5D59CE9473C26B8AEF7AD68EF0727B6EC2E0C │ │ │ │ │ @@ -2712,72 +2711,64 @@ │ │ │ │ │ 7CA1534C4D5B05FC33F83790ECFD7641DF3FB94289E2A1F6E7D29AB1228A867A │ │ │ │ │ 6E1EF0E9C6F899B491DC18401C2C0A05FFFED46A72C245F7529B8EA55A038082 │ │ │ │ │ 8512307217D2A233C37004085BA3AEE379269F9FA7D0ADB4B19A95CC2AFE686E │ │ │ │ │ 55D88E47257C1FE6F235FEA295910569FE6DD5995512562359CC821E85A6C7A5 │ │ │ │ │ 79B470A9E340A6985189FF8B6AF914A6B0ECF93F47903221F95DE894A8F05B05 │ │ │ │ │ B7D99CD533EC5F931B18E6B39BECF67FA2D6DD1AEC76772B068BE06335A94C05 │ │ │ │ │ 7A4DDEE77B66101DA855C17AC312600370B34E31F5EC3A01300A8EB60B4C9767 │ │ │ │ │ -1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004B9BA1CC │ │ │ │ │ -580D3C6BDA4DC1B80B4365F1C80512453FC5316EC2D928FB731C3D6403E3C18B │ │ │ │ │ -E8424D644DF5E9A2134229C5C91CA68DB8E85BA2BB40F538F585DA6FA4037718 │ │ │ │ │ -B8053EBBA1E765346BCD5BDAA6C38115D31611D8A87A2238C145F2DA2F92E4DF │ │ │ │ │ -3987BD9C4D2A3D460E8941A68B125BCD9EE4F9FD262C4C8A71F47A2C81975635 │ │ │ │ │ -F1B981C274C53FA2ACCDE4C9D0A7C62D6C1EFF91CFC6712CA6A9F333C9564FCB │ │ │ │ │ -2A70F0AD715A79B10A08AB069E2A3C93BC0AED19D0CA10134B8DDDE8AF548DB2 │ │ │ │ │ -3A4AAA9C29682CF135BB767DAA16169A127EB50A7EECEB6480CF56A7D0F8AC56 │ │ │ │ │ -4A5090B3D75A790372886AF568D94C8165975A05BFBFDF1FFBA45F70700BB9E0 │ │ │ │ │ -57F3249EF9E9C8AD9CBCF6E4FD592DC4CDD2CC7C0BC3130C1059096C657BE453 │ │ │ │ │ -A2CBACE93420210E27AF56CA229BD6D982FB68B3FDC6D44478B922C4231C47EE │ │ │ │ │ -E500232F6C11D92DEB955F66DF52B92B22E7352790CC2DCBAC53965D57AC2920 │ │ │ │ │ -68B7D520DE25047146EFEB06B9AD4E2A94243C7E5239F0BC2FC312B16051D52C │ │ │ │ │ -0B92C217B6B42997321AE4F8BB066754B7AA3F15069EF59224E8A442CE471AA7 │ │ │ │ │ -E8049A3DD9EDA09CCEE4998998661CF7DB35E952F6C65DAEB3013951C59F3E09 │ │ │ │ │ -157F313B0237876E1C0190F0473819570B8C0205AADF05D787CC00979CFB327A │ │ │ │ │ -289382B22DDA6F12804ED0ED5B179E36A995A2A59E1B66E75130DBE9109C813B │ │ │ │ │ -94403E0DEA8314A1E9DB474D7FA83C0BAFD08033E6A6215844C1D26BE15F1251 │ │ │ │ │ -A1605E8DF9A9C601ED37379530BC1C82BE5463C6C711C5652BFD6262485AA9CA │ │ │ │ │ -B8C4A117593001D08D980041E2A83C190DCE8E6CD3D334E5CC19FC05DB30F7F7 │ │ │ │ │ -24A305C4DBB31F0651392B99D44B4302333BDF7E326FD256DD75D309C6E73F85 │ │ │ │ │ -FA71B35FD1F9BEFF4C7A1076362EEB0A85492933B6006086A7B8C1928CF2D1EE │ │ │ │ │ -FD4344409257BB802C117E739960821CD3C88BFBA5669FF16F610AD638AF3677 │ │ │ │ │ -8674C985E6767253ED5769F71BEA5E9BB02A751F9E62EE2B18AC19D975FDEAE9 │ │ │ │ │ -8B8822367FF177A7E850766DE99ED3366D46464612926430012212A90F8E85F4 │ │ │ │ │ -4760B40D5B86B90819EE410382C23E86DCAF4F0FF5DFEB2C285965F4DCF2FB2B │ │ │ │ │ -457C0A0427A8D4ADA514E9DACD0F9367E1DA225DB21DA4DDAE33F2B529686D92 │ │ │ │ │ -AC085B345565F9DFFA012FD494DBB2E0B44A0787B2B72DC8D25399DAAE8864B7 │ │ │ │ │ -E84AA99DAFCEAF18F8B41882720316450F1B1CA48B418C9736E5CE4AFF996111 │ │ │ │ │ -5F7FE80958B6A3498508E9693CB134402D92E30D4C2939070D4647E13682290E │ │ │ │ │ -1D0820A3FCA7147157D09D1A40771F214EAE7DD743EA26839E535CA186C05CB8 │ │ │ │ │ -4874988AA1104D85AF0220FE7224344FF624E794BD2454E1C0AC971522FBECBA │ │ │ │ │ -B2497F25CD621B77EC5160973EF5ECC39C183DC051B0DFCB090194A2525BD96E │ │ │ │ │ -28593FDA80D8D259F039416D5F9AF0AD3C9A105B49DAF6E681921E369B7666C6 │ │ │ │ │ -2B73DB37447B00AE96317C2F1C44FB6E6EFD740BAB20FA03A8CE018EC8415582 │ │ │ │ │ -FB06E88A2971E3A480FB1EB4FE93CC7E5179721CAABEE88742B13CF0405F49F4 │ │ │ │ │ -945E587668C821D8C06D6847B6DF84CAFFCD4628670D551FC5F7236875BE1207 │ │ │ │ │ -634BA7F70A19B658FAE7D86F6D00ED28FBF29CC585DEE279325EEF8B0CCB6149 │ │ │ │ │ -E46E638C73D75148F18A636DBC2DD96ED34F68A5A09A3700B1EA34B2D142807C │ │ │ │ │ -F8709D81180783548EAE6F457BF968602076A1069163E3C15BBCEF659C6CF2E6 │ │ │ │ │ -0BB01BDC8E503802CC7969A5B8477E9788C5249B23B19669F5075E089738E49A │ │ │ │ │ -8671D7C1B1B47652F3D78BF2FF74EDB44BA5B092E8D5B85001E97F69D54AEEFC │ │ │ │ │ -88FC3CA1B0D5BAC39263B371005BCFA19AD197A31CC34D0BD55C2CA18C60C485 │ │ │ │ │ -5993F736EF1DD2C5D2B4D50B3D498861B4DF5E7AFF614BBCA4C2E6BECC0DCEF5 │ │ │ │ │ -95F0D686188014C530D8E37650CDCAE721B4AFB0F178BC744BDDDED45DAB7FEB │ │ │ │ │ -A10B975E26099E3DC61116D6BF554574F948895B88EEFE03DCC5351190836AD4 │ │ │ │ │ -EBC1AC55C6D099A8E7B0A372D290C481F44FA464B9C11A0BC991CB045E0AAAC4 │ │ │ │ │ -5C73CA43A4F17D1ADDD33D1B917FF95BFF411C8409F41553B1BC97DE47E3A1F4 │ │ │ │ │ -A5C1D1B7B1BF7E2507AC53956C141411F4F657E37981996DD7BB7ADB2CB6AE01 │ │ │ │ │ -73D0876B8F896F626D5022FE53BA34D5668BD698BE8D5CCAD083CBCEF440BE6A │ │ │ │ │ -8090EB1CDEE5F99C8988650BD4E539B357C31C597D8A9104A9D5967D4E906CAD │ │ │ │ │ -2A65575A884B1C5F6CC509E742FA9DDD66494F219178161AF72C50848E226A95 │ │ │ │ │ -A8C247FF9FF0BABD073021271B5C0692F9BE220071DAB09E5A026629371EE3C4 │ │ │ │ │ -A6E4FA94625D87A5B66EF077ED54C72B1052AEAA9637B30C76EF8EB04AD5F476 │ │ │ │ │ -D15F1C93C0BC6E0F67B366097BBED03FE82C040F9EF02866159B46854E11D44F │ │ │ │ │ -54AE6748A7E61B993A4EECD3B8BE3B5897A66BBCDFE24F65BC2AD5AB49048CF1 │ │ │ │ │ -647203823F84DF5CB483096F9D96AEE3A2855E479B72A14A67C633CE99C101CF │ │ │ │ │ -EFAE939BF9B02E710D │ │ │ │ │ +1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004ACD1870 │ │ │ │ │ +A5EA947858F5795870BFE1343AD803FB854BF8F5A4E794E8EC57BE41DB5B8734 │ │ │ │ │ +13E47950F29A81EA0C81EA798863883D7F41F78325CA190CBBFFE822AE494550 │ │ │ │ │ +4BE83703071FC9512D128927AF3F63CEF8F86ABE1E15D7B4DDD39576E7DFF45E │ │ │ │ │ +3CB4115AAB1830DE8647B915DB4BEBEB5235C281E098B899BAB951D8D5798F01 │ │ │ │ │ +7F7C47336D31438E5126738AFEAB29E9A7CBE06DE4DD604477B542D2620DFD58 │ │ │ │ │ +28FE34238572F23C5A8EB7ACEE1E154DA13FC1A5AA67A3BA8C5CDFB2B80312C9 │ │ │ │ │ +BC9FAE56D08DDFA9498E6EF0D0F6BD18B3923E0B670B0740528BC843610736CB │ │ │ │ │ +80228C105C2F72C3C22D610C3D8C268DEEA2AEEE3221E198E79FE2966487360C │ │ │ │ │ +84AE08AC326F48B21447652121B1EB68AF856055EEA65B6B625BF622CBFC2D1C │ │ │ │ │ +EF943CC4CAF2C715782C9EF9A9BA4689BFC6B6A82F8D55795BE8111E2C7DE520 │ │ │ │ │ +367362304B6A48186C842033E715A46265A352472F4F7313248EBCD26BEA97E7 │ │ │ │ │ +B814A61D4B7ADCB5C5F21AA34E0C1269E8426DBFB511DE6E26B960456C8F8520 │ │ │ │ │ +5F0DD382289A62AF0B935EDB5B2394538C5F0EE72962D2F98F3C38CD7C027B9F │ │ │ │ │ +E230E67E40FEFBDED06B3423C9DFD669E6B5BC913E0FF75786A64A6C11D4FE89 │ │ │ │ │ +1B918DC0E953C52CFD153063CD0D2A78B43F8712243845E6F2CBA1DB610F403D │ │ │ │ │ +A98D06D95FF44C7AC029092B666A8B0DCEA95B34F5ACC10E8611BADE6A24469C │ │ │ │ │ +0C01D95BFB445FA22CD38D033E4D24E006BB9D54EE41EF7AD5AC9C299721F61A │ │ │ │ │ +F01B6EDCDF428BD9195A13C5B1027358F8A203F828A1DD9622243B2D76C6F1BA │ │ │ │ │ +9F2D7E9D4879FC668ABC750CD25415DC6CCF2257C28F78D3F9BE499CC0FF2F80 │ │ │ │ │ +2C2CD1DEFABD6668FCA76E1D629A344333E33DA24B86D2E9F8F5EE1C29974640 │ │ │ │ │ +C3E78E999BAB313400041DADDDFDBFFCC419F129A84F4D412B79E8BE4511CA00 │ │ │ │ │ +F92A4F3CDD2E51345D3965C104F06B6503445DC20224CB7606A9D7D5F9EE45E6 │ │ │ │ │ +1B2963DA96AA2AB1BA5BE29656E666E4D0E122DE58EEA68E04ED76438DA03E65 │ │ │ │ │ +B80055A86B7B2A26BAE6BBB8835E17F9696E9B3CD34571BA75C76D4D2CCC48F1 │ │ │ │ │ +7534C1EF9127E374D65D05B8072E08D6C72A0B4A35EA0DD717743C66D105CCD8 │ │ │ │ │ +7355F13E9C38C1A4351624E689ED7909100942FA0474842EE44DEC3279E1A1CD │ │ │ │ │ +8064666EB845CA7C3E906B67C0BF96A28D514DB2E4A1E4AF287350B03762A2CF │ │ │ │ │ +13B18AC3F5D2F3B74A1D50267C03EFB74B888E1D24ABEEA4A885F4D0BF14C0D8 │ │ │ │ │ +289AC79D6D98E2A2C831672FB1F3457564CD161ADC3AF610D88201AB5B0C10CB │ │ │ │ │ +5ECCC2D5C4AF39C8CB3044BF9EC791BA45D29C2B51EA0483D19822C264CE6FA3 │ │ │ │ │ +5C97F2DF5A78CB93528E99B9ED7CB121C83130C129B849B52A36EBD88AF19DD3 │ │ │ │ │ +C5CABE831027388EF86BD5CBD90AAAC089775938A321C44D4DDA67A51312D8AB │ │ │ │ │ +C509DDBE7044A107AB2BE9C4C9556F85C529B174A7778B489BF28EC07A834542 │ │ │ │ │ +8B31F2925C21FB2096877711F998763D5A8495002B8E080AF8DBB1B3106EDDBA │ │ │ │ │ +35121D52E0846A7AF3ABEDF87BDE4FA665673A9B80CA538B98F873947AA17EF4 │ │ │ │ │ +9BB182917E9D79BC7EC681E93710D6A1D6B0E4A7FA9452FC1C431808174F3AB7 │ │ │ │ │ +F3914FBC86CB34E8583457243C3C7BE4BC166C7397689BC6FFB82EA2967E88EE │ │ │ │ │ +464F96EDA144DE2B64401B8E577ABCA2D826FE0B92E21FFAE3E81EBB6B6EB36E │ │ │ │ │ +9B1A8FE3884CA398C03135FD49D51724FC1268E9482E41FAEA2FC6C809006B8F │ │ │ │ │ +5D4F9E038450AD3A6041C16FD1C7E5FC80C0E033CE57E64863E014531D94DF1E │ │ │ │ │ +31D7D038AFCB60715AA73C1E96F113A24C5AF35BBEB61C4D079ED034ED83AA4A │ │ │ │ │ +E12448E618330463304788BCF40561CD63167B3BF144F408E2B89E60B8BA13EF │ │ │ │ │ +3B57D286FD23D4FA8BAEFF98DC1188B1982956CC1DCAEFC7D949B7B4E3BE8F8A │ │ │ │ │ +BFE2C9D938DD13EFEE7123576608D9396F260907DA98AE2D3DD5822306CBC8A6 │ │ │ │ │ +B083C697DDA3C62EE7879436A9FD8EE0034B105105B3F122F893EA2126EBE8A9 │ │ │ │ │ +5CBF2BD248DD9FBEF0040C25797BD13B69A8C9F0D4E4F935C61ED30487CCDB1A │ │ │ │ │ +0339006E78EE1755929D2412776EC7DB1F666DBDD28EA8AC7397F809C7F38A41 │ │ │ │ │ +5B3BF6C75F4F35C90141EB08377AF452CF840FEA938805F9D14E02DC29215B4E │ │ │ │ │ +F1EB │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ @@ -5366,16 +5357,16 @@ │ │ │ │ │ /Fe load 0 Fe currentfont 91.25 scalefont put/FMat X/FBB │ │ │ │ │ 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 23[45 19[83 │ │ │ │ │ -18[25 2[45 2[45 1[45 45 45 3[25 44[{}10 90.9091 /CMSL10 │ │ │ │ │ +17[71 1[71{}8 90.9091 /CMSY10 rf /Fi 138[51 6[51 8[40 │ │ │ │ │ +26[47 15[25 4[45 2[45 1[45 3[25 44[{}9 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 1[48 1[48 48 48 48 48 │ │ │ │ │ @@ -5503,17 +5494,17 @@ │ │ │ │ │ (\(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 1227 4 v │ │ │ │ │ -1409 w Fm(Chv)29 b Fi(:)41 b Fl(DRAFT)30 b Fi(Ma)m(y)h(17,)h(2024)p │ │ │ │ │ -2674 100 V 111 399 a Fn(1.)46 b(Assem)m(ble)39 b(en)m(tries)g(from)f │ │ │ │ │ +TeXDict begin 2 1 bop 0 100 a Fn(2)p 136 100 1220 4 v │ │ │ │ │ +1402 w Fm(Chv)29 b Fi(:)41 b Fl(DRAFT)30 b Fi(June)f(20,)j(2025)p │ │ │ │ │ +2681 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 │ │ │ │ │ @@ -5696,17 +5687,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 1227 4 v 1408 100 a Fm(Chv)30 │ │ │ │ │ -b Fi(:)40 b Fl(DRAFT)121 b Fi(Ma)m(y)32 b(17,)f(2024)p │ │ │ │ │ -2626 100 V 1227 w Fn(3)0 399 y(of)38 b(comm)m(unication.)63 │ │ │ │ │ +TeXDict begin 3 2 bop 91 100 1220 4 v 1401 100 a Fm(Chv)30 │ │ │ │ │ +b Fi(:)40 b Fl(DRAFT)121 b Fi(June)30 b(20,)h(2025)p │ │ │ │ │ +2633 100 V 1220 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 │ │ │ │ │ @@ -5775,17 +5766,17 @@ │ │ │ │ │ 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 1227 4 v │ │ │ │ │ -1409 w Fm(Chv)29 b Fi(:)41 b Fl(DRAFT)30 b Fi(Ma)m(y)h(17,)h(2024)p │ │ │ │ │ -2674 100 V 137 399 a Fe(\210)45 b Fm(DV)i(wrkDV)29 b │ │ │ │ │ +TeXDict begin 4 3 bop 0 100 a Fn(4)p 136 100 1220 4 v │ │ │ │ │ +1402 w Fm(Chv)29 b Fi(:)41 b Fl(DRAFT)30 b Fi(June)f(20,)j(2025)p │ │ │ │ │ +2681 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 │ │ │ │ │ @@ -5845,17 +5836,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 1227 4 v 1408 100 a Fm(Chv)30 │ │ │ │ │ -b Fi(:)40 b Fl(DRAFT)121 b Fi(Ma)m(y)32 b(17,)f(2024)p │ │ │ │ │ -2626 100 V 1227 w Fn(5)0 399 y Fc(1.2.2)112 b(Instance)38 │ │ │ │ │ +TeXDict begin 5 4 bop 91 100 1220 4 v 1401 100 a Fm(Chv)30 │ │ │ │ │ +b Fi(:)40 b Fl(DRAFT)121 b Fi(June)30 b(20,)h(2025)p │ │ │ │ │ +2633 100 V 1220 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 │ │ │ │ │ @@ -5915,17 +5906,17 @@ │ │ │ │ │ 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 1227 4 v │ │ │ │ │ -1409 w Fm(Chv)29 b Fi(:)41 b Fl(DRAFT)30 b Fi(Ma)m(y)h(17,)h(2024)p │ │ │ │ │ -2674 100 V 111 399 a Fn(8.)46 b Fm(double)g(*)i(Chv_entries)d(\()i(Chv) │ │ │ │ │ +TeXDict begin 6 5 bop 0 100 a Fn(6)p 136 100 1220 4 v │ │ │ │ │ +1402 w Fm(Chv)29 b Fi(:)41 b Fl(DRAFT)30 b Fi(June)f(20,)j(2025)p │ │ │ │ │ +2681 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 │ │ │ │ │ @@ -6005,17 +5996,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 1227 4 v 1408 100 a Fm(Chv)30 │ │ │ │ │ -b Fi(:)40 b Fl(DRAFT)121 b Fi(Ma)m(y)32 b(17,)f(2024)p │ │ │ │ │ -2626 100 V 1227 w Fn(7)66 399 y(15.)46 b Fm(Chv_locationOfComplexEntr)o │ │ │ │ │ +TeXDict begin 7 6 bop 91 100 1220 4 v 1401 100 a Fm(Chv)30 │ │ │ │ │ +b Fi(:)40 b Fl(DRAFT)121 b Fi(June)30 b(20,)h(2025)p │ │ │ │ │ +2633 100 V 1220 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 │ │ │ │ │ @@ -6088,17 +6079,17 @@ │ │ │ │ │ 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 1227 4 v │ │ │ │ │ -1409 w Fm(Chv)29 b Fi(:)41 b Fl(DRAFT)30 b Fi(Ma)m(y)h(17,)h(2024)p │ │ │ │ │ -2674 100 V 0 399 a Fc(1.2.4)112 b(Searc)m(h)38 b(metho)s(ds)111 │ │ │ │ │ +TeXDict begin 8 7 bop 0 100 a Fn(8)p 136 100 1220 4 v │ │ │ │ │ +1402 w Fm(Chv)29 b Fi(:)41 b Fl(DRAFT)30 b Fi(June)f(20,)j(2025)p │ │ │ │ │ +2681 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 │ │ │ │ │ @@ -6166,17 +6157,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 1227 4 v 1408 100 a Fm(Chv)30 │ │ │ │ │ -b Fi(:)40 b Fl(DRAFT)121 b Fi(Ma)m(y)32 b(17,)f(2024)p │ │ │ │ │ -2626 100 V 1227 w Fn(9)227 399 y(This)h(metho)s(d)g(returns)g(the)h(lo) │ │ │ │ │ +TeXDict begin 9 8 bop 91 100 1220 4 v 1401 100 a Fm(Chv)30 │ │ │ │ │ +b Fi(:)40 b Fl(DRAFT)121 b Fi(June)30 b(20,)h(2025)p │ │ │ │ │ +2633 100 V 1220 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 │ │ │ │ │ @@ -6260,17 +6251,17 @@ │ │ │ │ │ (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 1204 4 │ │ │ │ │ -v 1386 w Fm(Chv)30 b Fi(:)40 b Fl(DRAFT)31 b Fi(Ma)m(y)g(17,)h(2024)p │ │ │ │ │ -2696 100 V 227 399 a Fl(Err)-5 b(or)47 b(che)-5 b(cking:)67 │ │ │ │ │ +TeXDict begin 10 9 bop 0 100 a Fn(10)p 182 100 1197 4 │ │ │ │ │ +v 1379 w Fm(Chv)30 b Fi(:)41 b Fl(DRAFT)30 b Fi(June)f(20,)j(2025)p │ │ │ │ │ +2703 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 │ │ │ │ │ @@ -6367,17 +6358,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 1204 4 v 1385 100 a Fm(Chv)30 │ │ │ │ │ -b Fi(:)41 b Fl(DRAFT)121 b Fi(Ma)m(y)31 b(17,)h(2024)p │ │ │ │ │ -2604 100 V 1204 w Fn(11)227 399 y(call)d(to)g(assem)m(ble)g(en)m(tries) │ │ │ │ │ +TeXDict begin 11 10 bop 91 100 1197 4 v 1378 100 a Fm(Chv)30 │ │ │ │ │ +b Fi(:)41 b Fl(DRAFT)121 b Fi(June)29 b(20,)j(2025)p │ │ │ │ │ +2611 100 V 1197 w Fn(11)227 399 y(call)d(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 │ │ │ │ │ @@ -6465,17 +6456,17 @@ │ │ │ │ │ (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 1204 │ │ │ │ │ -4 v 1386 w Fm(Chv)30 b Fi(:)40 b Fl(DRAFT)31 b Fi(Ma)m(y)g(17,)h(2024)p │ │ │ │ │ -2696 100 V 227 399 a Fl(Err)-5 b(or)34 b(che)-5 b(cking:)40 │ │ │ │ │ +TeXDict begin 12 11 bop 0 100 a Fn(12)p 182 100 1197 │ │ │ │ │ +4 v 1379 w Fm(Chv)30 b Fi(:)41 b Fl(DRAFT)30 b Fi(June)f(20,)j(2025)p │ │ │ │ │ +2703 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 │ │ │ │ │ @@ -6543,17 +6534,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 1204 4 v 1385 100 a Fm(Chv)30 │ │ │ │ │ -b Fi(:)41 b Fl(DRAFT)121 b Fi(Ma)m(y)31 b(17,)h(2024)p │ │ │ │ │ -2604 100 V 1204 w Fn(13)227 399 y(This)e(metho)s(d)g(is)g(used)g(to)h │ │ │ │ │ +TeXDict begin 13 12 bop 91 100 1197 4 v 1378 100 a Fm(Chv)30 │ │ │ │ │ +b Fi(:)41 b Fl(DRAFT)121 b Fi(June)29 b(20,)j(2025)p │ │ │ │ │ +2611 100 V 1197 w Fn(13)227 399 y(This)e(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 │ │ │ │ │ @@ -6633,17 +6624,17 @@ │ │ │ │ │ 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 1204 │ │ │ │ │ -4 v 1386 w Fm(Chv)30 b Fi(:)40 b Fl(DRAFT)31 b Fi(Ma)m(y)g(17,)h(2024)p │ │ │ │ │ -2696 100 V 111 399 a Fn(4.)46 b Fm(int)h(Chv_copyBigEntriesToVecto)o(r) │ │ │ │ │ +TeXDict begin 14 13 bop 0 100 a Fn(14)p 182 100 1197 │ │ │ │ │ +4 v 1379 w Fm(Chv)30 b Fi(:)41 b Fl(DRAFT)30 b Fi(June)f(20,)j(2025)p │ │ │ │ │ +2703 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 │ │ │ │ │ @@ -6731,17 +6722,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 1204 4 v 1385 100 a Fm(Chv)30 │ │ │ │ │ -b Fi(:)41 b Fl(DRAFT)121 b Fi(Ma)m(y)31 b(17,)h(2024)p │ │ │ │ │ -2604 100 V 1204 w Fn(15)227 399 y Fl(Err)-5 b(or)35 b(che)-5 │ │ │ │ │ +TeXDict begin 15 14 bop 91 100 1197 4 v 1378 100 a Fm(Chv)30 │ │ │ │ │ +b Fi(:)41 b Fl(DRAFT)121 b Fi(June)29 b(20,)j(2025)p │ │ │ │ │ +2611 100 V 1197 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 │ │ │ │ │ @@ -6811,17 +6802,17 @@ │ │ │ │ │ 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 1204 │ │ │ │ │ -4 v 1386 w Fm(Chv)30 b Fi(:)40 b Fl(DRAFT)31 b Fi(Ma)m(y)g(17,)h(2024)p │ │ │ │ │ -2696 100 V 227 399 a Fn(metho)s(d)i(as)h(it)g(c)m(hanges)h(the)e(state) │ │ │ │ │ +TeXDict begin 16 15 bop 0 100 a Fn(16)p 182 100 1197 │ │ │ │ │ +4 v 1379 w Fm(Chv)30 b Fi(:)41 b Fl(DRAFT)30 b Fi(June)f(20,)j(2025)p │ │ │ │ │ +2703 100 V 227 399 a Fn(metho)s(d)i(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 │ │ │ │ │ @@ -6875,17 +6866,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 1204 4 v 1385 100 a Fm(Chv)30 │ │ │ │ │ -b Fi(:)41 b Fl(DRAFT)121 b Fi(Ma)m(y)31 b(17,)h(2024)p │ │ │ │ │ -2604 100 V 1204 w Fn(17)0 399 y Fc(1.2.12)113 b(IO)37 │ │ │ │ │ +TeXDict begin 17 16 bop 91 100 1197 4 v 1378 100 a Fm(Chv)30 │ │ │ │ │ +b Fi(:)41 b Fl(DRAFT)121 b Fi(June)29 b(20,)j(2025)p │ │ │ │ │ +2611 100 V 1197 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 │ │ │ │ │ @@ -6945,17 +6936,17 @@ │ │ │ │ │ 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 1204 │ │ │ │ │ -4 v 1386 w Fm(Chv)30 b Fi(:)40 b Fl(DRAFT)31 b Fi(Ma)m(y)g(17,)h(2024)p │ │ │ │ │ -2696 100 V 111 399 a Fn(2.)46 b Fm(test_assmbChv)e(msglvl)j(msgFile)e │ │ │ │ │ +TeXDict begin 18 17 bop 0 100 a Fn(18)p 182 100 1197 │ │ │ │ │ +4 v 1379 w Fm(Chv)30 b Fi(:)41 b Fl(DRAFT)30 b Fi(June)f(20,)j(2025)p │ │ │ │ │ +2703 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) │ │ │ │ │ @@ -7032,17 +7023,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 1204 4 v 1385 100 a Fm(Chv)30 │ │ │ │ │ -b Fi(:)41 b Fl(DRAFT)121 b Fi(Ma)m(y)31 b(17,)h(2024)p │ │ │ │ │ -2604 100 V 1204 w Fn(19)337 399 y Fe(\210)45 b Fn(The)35 │ │ │ │ │ +TeXDict begin 19 18 bop 91 100 1197 4 v 1378 100 a Fm(Chv)30 │ │ │ │ │ +b Fi(:)41 b Fl(DRAFT)121 b Fi(June)29 b(20,)j(2025)p │ │ │ │ │ +2611 100 V 1197 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 │ │ │ │ │ @@ -7118,17 +7109,17 @@ │ │ │ │ │ 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 1204 │ │ │ │ │ -4 v 1386 w Fm(Chv)30 b Fi(:)40 b Fl(DRAFT)31 b Fi(Ma)m(y)g(17,)h(2024)p │ │ │ │ │ -2696 100 V 337 399 a Fe(\210)45 b Fn(The)30 b Fm(nD)g │ │ │ │ │ +TeXDict begin 20 19 bop 0 100 a Fn(20)p 182 100 1197 │ │ │ │ │ +4 v 1379 w Fm(Chv)30 b Fi(:)41 b Fl(DRAFT)30 b Fi(June)f(20,)j(2025)p │ │ │ │ │ +2703 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 │ │ │ │ │ @@ -7200,17 +7191,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 1204 4 v 1385 100 a Fm(Chv)30 │ │ │ │ │ -b Fi(:)41 b Fl(DRAFT)121 b Fi(Ma)m(y)31 b(17,)h(2024)p │ │ │ │ │ -2604 100 V 1204 w Fn(21)337 399 y Fe(\210)45 b Fn(The)33 │ │ │ │ │ +TeXDict begin 21 20 bop 91 100 1197 4 v 1378 100 a Fm(Chv)30 │ │ │ │ │ +b Fi(:)41 b Fl(DRAFT)121 b Fi(June)29 b(20,)j(2025)p │ │ │ │ │ +2611 100 V 1197 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 │ │ │ │ │ @@ -7280,17 +7271,17 @@ │ │ │ │ │ (\(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 1204 │ │ │ │ │ -4 v 1386 w Fm(Chv)30 b Fi(:)40 b Fl(DRAFT)31 b Fi(Ma)m(y)g(17,)h(2024)p │ │ │ │ │ -2696 100 V 337 399 a Fe(\210)45 b Fn(The)20 b Fm(symflag)e │ │ │ │ │ +TeXDict begin 22 21 bop 0 100 a Fn(22)p 182 100 1197 │ │ │ │ │ +4 v 1379 w Fm(Chv)30 b Fi(:)41 b Fl(DRAFT)30 b Fi(June)f(20,)j(2025)p │ │ │ │ │ +2703 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 │ │ │ │ │ @@ -7365,17 +7356,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 1204 4 v 1385 100 a Fm(Chv)30 │ │ │ │ │ -b Fi(:)41 b Fl(DRAFT)121 b Fi(Ma)m(y)31 b(17,)h(2024)p │ │ │ │ │ -2604 100 V 1204 w Fn(23)337 399 y Fe(\210)45 b Fn(The)30 │ │ │ │ │ +TeXDict begin 23 22 bop 91 100 1197 4 v 1378 100 a Fm(Chv)30 │ │ │ │ │ +b Fi(:)41 b Fl(DRAFT)121 b Fi(June)29 b(20,)j(2025)p │ │ │ │ │ +2611 100 V 1197 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 May 17, 2024 │ │ │ │ │ │ + 2 Chv : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 3 │ │ │ │ │ │ + Chv : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 4 Chv : DRAFT June 20, 2025 │ │ │ │ │ │ • 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 May 17, 2024 5 │ │ │ │ │ │ + Chv : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 6 Chv : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 9 │ │ │ │ │ │ + Chv : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 10 Chv : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 11 │ │ │ │ │ │ + Chv : DRAFT June 20, 2025 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 │ │ │ │ │ │ @@ -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 May 17, 2024 │ │ │ │ │ │ + 12 Chv : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 13 │ │ │ │ │ │ + Chv : DRAFT June 20, 2025 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. │ │ │ │ │ │ @@ -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 May 17, 2024 │ │ │ │ │ │ + 14 Chv : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 15 │ │ │ │ │ │ + Chv : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 16 Chv : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 17 │ │ │ │ │ │ + Chv : DRAFT June 20, 2025 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 │ │ │ │ │ │ @@ -619,15 +619,15 @@ │ │ │ │ │ │ • Thesymflagparameteristhesymmetryflag—SPOOLES SYMMETRIC,SPOOLES HERMITIAN │ │ │ │ │ │ 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 May 17, 2024 │ │ │ │ │ │ + 18 Chv : DRAFT June 20, 2025 │ │ │ │ │ │ 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,15 +658,15 @@ │ │ │ │ │ │ • 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 May 17, 2024 19 │ │ │ │ │ │ + Chv : DRAFT June 20, 2025 19 │ │ │ │ │ │ • The storeflag parameter is the storage flag, to store by rows, use SPOOLES BY ROWS, │ │ │ │ │ │ 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 │ │ │ │ │ │ @@ -698,15 +698,15 @@ │ │ │ │ │ │ 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. │ │ │ │ │ │ • 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 May 17, 2024 │ │ │ │ │ │ + 20 Chv : DRAFT June 20, 2025 │ │ │ │ │ │ • 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,15 +735,15 @@ │ │ │ │ │ │ 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 May 17, 2024 21 │ │ │ │ │ │ + Chv : DRAFT June 20, 2025 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. │ │ │ │ │ │ • 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 │ │ │ │ │ │ @@ -772,15 +772,15 @@ │ │ │ │ │ │ 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 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 May 17, 2024 │ │ │ │ │ │ + 22 Chv : DRAFT June 20, 2025 │ │ │ │ │ │ • 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 May 17, 2024 23 │ │ │ │ │ │ + Chv : DRAFT June 20, 2025 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 2024.05.17:2217 │ │ │ │ │ +%DVIPSSource: TeX output 2025.06.20:0449 │ │ │ │ │ %%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 │ │ │ │ │ @@ -1760,22 +1760,21 @@ │ │ │ │ │ /UnderlinePosition -100 def │ │ │ │ │ /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 49 /one put │ │ │ │ │ dup 50 /two put │ │ │ │ │ -dup 52 /four put │ │ │ │ │ -dup 55 /seven put │ │ │ │ │ +dup 53 /five put │ │ │ │ │ dup 58 /colon put │ │ │ │ │ -dup 77 /M put │ │ │ │ │ -dup 97 /a put │ │ │ │ │ -dup 121 /y put │ │ │ │ │ +dup 74 /J put │ │ │ │ │ +dup 101 /e put │ │ │ │ │ +dup 110 /n put │ │ │ │ │ +dup 117 /u put │ │ │ │ │ readonly def │ │ │ │ │ currentdict end │ │ │ │ │ currentfile eexec │ │ │ │ │ D9D66F633B846AB284BCF8B0411B772DE5CE32340DC6F28AF40857E4451976E7 │ │ │ │ │ 5182433CF9F333A38BD841C0D4E68BF9E012EB32A8FFB76B5816306B5EDF7C99 │ │ │ │ │ 8B3A16D9B4BC056662E32C7CD0123DFAEB734C7532E64BBFBF5A60336E646716 │ │ │ │ │ EFB852C877F440D329172C71F1E5D59CE9473C26B8AEF7AD68EF0727B6EC2E0C │ │ │ │ │ @@ -1956,72 +1955,64 @@ │ │ │ │ │ 7CA1534C4D5B05FC33F83790ECFD7641DF3FB94289E2A1F6E7D29AB1228A867A │ │ │ │ │ 6E1EF0E9C6F899B491DC18401C2C0A05FFFED46A72C245F7529B8EA55A038082 │ │ │ │ │ 8512307217D2A233C37004085BA3AEE379269F9FA7D0ADB4B19A95CC2AFE686E │ │ │ │ │ 55D88E47257C1FE6F235FEA295910569FE6DD5995512562359CC821E85A6C7A5 │ │ │ │ │ 79B470A9E340A6985189FF8B6AF914A6B0ECF93F47903221F95DE894A8F05B05 │ │ │ │ │ B7D99CD533EC5F931B18E6B39BECF67FA2D6DD1AEC76772B068BE06335A94C05 │ │ │ │ │ 7A4DDEE77B66101DA855C17AC312600370B34E31F5EC3A01300A8EB60B4C9767 │ │ │ │ │ -1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004B9BA1CC │ │ │ │ │ -580D3C6BDA4DC1B80B4365F1C80512453FC5316EC2D928FB731C3D6403E3C18B │ │ │ │ │ -E8424D644DF5E9A2134229C5C91CA68DB8E85BA2BB40F538F585DA6FA4037718 │ │ │ │ │ -B8053EBBA1E765346BCD5BDAA6C38115D31611D8A87A2238C145F2DA2F92E4DF │ │ │ │ │ -3987BD9C4D2A3D460E8941A68B125BCD9EE4F9FD262C4C8A71F47A2C81975635 │ │ │ │ │ -F1B981C274C53FA2ACCDE4C9D0A7C62D6C1EFF91CFC6712CA6A9F333C9564FCB │ │ │ │ │ -2A70F0AD715A79B10A08AB069E2A3C93BC0AED19D0CA10134B8DDDE8AF548DB2 │ │ │ │ │ -3A4AAA9C29682CF135BB767DAA16169A127EB50A7EECEB6480CF56A7D0F8AC56 │ │ │ │ │ -4A5090B3D75A790372886AF568D94C8165975A05BFBFDF1FFBA45F70700BB9E0 │ │ │ │ │ -57F3249EF9E9C8AD9CBCF6E4FD592DC4CDD2CC7C0BC3130C1059096C657BE453 │ │ │ │ │ -A2CBACE93420210E27AF56CA229BD6D982FB68B3FDC6D44478B922C4231C47EE │ │ │ │ │ -E500232F6C11D92DEB955F66DF52B92B22E7352790CC2DCBAC53965D57AC2920 │ │ │ │ │ -68B7D520DE25047146EFEB06B9AD4E2A94243C7E5239F0BC2FC312B16051D52C │ │ │ │ │ -0B92C217B6B42997321AE4F8BB066754B7AA3F15069EF59224E8A442CE471AA7 │ │ │ │ │ -E8049A3DD9EDA09CCEE4998998661CF7DB35E952F6C65DAEB3013951C59F3E09 │ │ │ │ │ -157F313B0237876E1C0190F0473819570B8C0205AADF05D787CC00979CFB327A │ │ │ │ │ -289382B22DDA6F12804ED0ED5B179E36A995A2A59E1B66E75130DBE9109C813B │ │ │ │ │ -94403E0DEA8314A1E9DB474D7FA83C0BAFD08033E6A6215844C1D26BE15F1251 │ │ │ │ │ -A1605E8DF9A9C601ED37379530BC1C82BE5463C6C711C5652BFD6262485AA9CA │ │ │ │ │ -B8C4A117593001D08D980041E2A83C190DCE8E6CD3D334E5CC19FC05DB30F7F7 │ │ │ │ │ -24A305C4DBB31F0651392B99D44B4302333BDF7E326FD256DD75D309C6E73F85 │ │ │ │ │ -FA71B35FD1F9BEFF4C7A1076362EEB0A85492933B6006086A7B8C1928CF2D1EE │ │ │ │ │ -FD4344409257BB802C117E739960821CD3C88BFBA5669FF16F610AD638AF3677 │ │ │ │ │ -8674C985E6767253ED5769F71BEA5E9BB02A751F9E62EE2B18AC19D975FDEAE9 │ │ │ │ │ -8B8822367FF177A7E850766DE99ED3366D46464612926430012212A90F8E85F4 │ │ │ │ │ -4760B40D5B86B90819EE410382C23E86DCAF4F0FF5DFEB2C285965F4DCF2FB2B │ │ │ │ │ -457C0A0427A8D4ADA514E9DACD0F9367E1DA225DB21DA4DDAE33F2B529686D92 │ │ │ │ │ -AC085B345565F9DFFA012FD494DBB2E0B44A0787B2B72DC8D25399DAAE8864B7 │ │ │ │ │ -E84AA99DAFCEAF18F8B41882720316450F1B1CA48B418C9736E5CE4AFF996111 │ │ │ │ │ -5F7FE80958B6A3498508E9693CB134402D92E30D4C2939070D4647E13682290E │ │ │ │ │ -1D0820A3FCA7147157D09D1A40771F214EAE7DD743EA26839E535CA186C05CB8 │ │ │ │ │ -4874988AA1104D85AF0220FE7224344FF624E794BD2454E1C0AC971522FBECBA │ │ │ │ │ -B2497F25CD621B77EC5160973EF5ECC39C183DC051B0DFCB090194A2525BD96E │ │ │ │ │ -28593FDA80D8D259F039416D5F9AF0AD3C9A105B49DAF6E681921E369B7666C6 │ │ │ │ │ -2B73DB37447B00AE96317C2F1C44FB6E6EFD740BAB20FA03A8CE018EC8415582 │ │ │ │ │ -FB06E88A2971E3A480FB1EB4FE93CC7E5179721CAABEE88742B13CF0405F49F4 │ │ │ │ │ -945E587668C821D8C06D6847B6DF84CAFFCD4628670D551FC5F7236875BE1207 │ │ │ │ │ -634BA7F70A19B658FAE7D86F6D00ED28FBF29CC585DEE279325EEF8B0CCB6149 │ │ │ │ │ -E46E638C73D75148F18A636DBC2DD96ED34F68A5A09A3700B1EA34B2D142807C │ │ │ │ │ -F8709D81180783548EAE6F457BF968602076A1069163E3C15BBCEF659C6CF2E6 │ │ │ │ │ -0BB01BDC8E503802CC7969A5B8477E9788C5249B23B19669F5075E089738E49A │ │ │ │ │ -8671D7C1B1B47652F3D78BF2FF74EDB44BA5B092E8D5B85001E97F69D54AEEFC │ │ │ │ │ -88FC3CA1B0D5BAC39263B371005BCFA19AD197A31CC34D0BD55C2CA18C60C485 │ │ │ │ │ -5993F736EF1DD2C5D2B4D50B3D498861B4DF5E7AFF614BBCA4C2E6BECC0DCEF5 │ │ │ │ │ -95F0D686188014C530D8E37650CDCAE721B4AFB0F178BC744BDDDED45DAB7FEB │ │ │ │ │ -A10B975E26099E3DC61116D6BF554574F948895B88EEFE03DCC5351190836AD4 │ │ │ │ │ -EBC1AC55C6D099A8E7B0A372D290C481F44FA464B9C11A0BC991CB045E0AAAC4 │ │ │ │ │ -5C73CA43A4F17D1ADDD33D1B917FF95BFF411C8409F41553B1BC97DE47E3A1F4 │ │ │ │ │ -A5C1D1B7B1BF7E2507AC53956C141411F4F657E37981996DD7BB7ADB2CB6AE01 │ │ │ │ │ -73D0876B8F896F626D5022FE53BA34D5668BD698BE8D5CCAD083CBCEF440BE6A │ │ │ │ │ -8090EB1CDEE5F99C8988650BD4E539B357C31C597D8A9104A9D5967D4E906CAD │ │ │ │ │ -2A65575A884B1C5F6CC509E742FA9DDD66494F219178161AF72C50848E226A95 │ │ │ │ │ -A8C247FF9FF0BABD073021271B5C0692F9BE220071DAB09E5A026629371EE3C4 │ │ │ │ │ -A6E4FA94625D87A5B66EF077ED54C72B1052AEAA9637B30C76EF8EB04AD5F476 │ │ │ │ │ -D15F1C93C0BC6E0F67B366097BBED03FE82C040F9EF02866159B46854E11D44F │ │ │ │ │ -54AE6748A7E61B993A4EECD3B8BE3B5897A66BBCDFE24F65BC2AD5AB49048CF1 │ │ │ │ │ -647203823F84DF5CB483096F9D96AEE3A2855E479B72A14A67C633CE99C101CF │ │ │ │ │ -EFAE939BF9B02E710D │ │ │ │ │ +1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004ACD1870 │ │ │ │ │ +A5EA947858F5795870BFE1343AD803FB854BF8F5A4E794E8EC57BE41DB5B8734 │ │ │ │ │ +13E47950F29A81EA0C81EA798863883D7F41F78325CA190CBBFFE822AE494550 │ │ │ │ │ +4BE83703071FC9512D128927AF3F63CEF8F86ABE1E15D7B4DDD39576E7DFF45E │ │ │ │ │ +3CB4115AAB1830DE8647B915DB4BEBEB5235C281E098B899BAB951D8D5798F01 │ │ │ │ │ +7F7C47336D31438E5126738AFEAB29E9A7CBE06DE4DD604477B542D2620DFD58 │ │ │ │ │ +28FE34238572F23C5A8EB7ACEE1E154DA13FC1A5AA67A3BA8C5CDFB2B80312C9 │ │ │ │ │ +BC9FAE56D08DDFA9498E6EF0D0F6BD18B3923E0B670B0740528BC843610736CB │ │ │ │ │ +80228C105C2F72C3C22D610C3D8C268DEEA2AEEE3221E198E79FE2966487360C │ │ │ │ │ +84AE08AC326F48B21447652121B1EB68AF856055EEA65B6B625BF622CBFC2D1C │ │ │ │ │ +EF943CC4CAF2C715782C9EF9A9BA4689BFC6B6A82F8D55795BE8111E2C7DE520 │ │ │ │ │ +367362304B6A48186C842033E715A46265A352472F4F7313248EBCD26BEA97E7 │ │ │ │ │ +B814A61D4B7ADCB5C5F21AA34E0C1269E8426DBFB511DE6E26B960456C8F8520 │ │ │ │ │ +5F0DD382289A62AF0B935EDB5B2394538C5F0EE72962D2F98F3C38CD7C027B9F │ │ │ │ │ +E230E67E40FEFBDED06B3423C9DFD669E6B5BC913E0FF75786A64A6C11D4FE89 │ │ │ │ │ +1B918DC0E953C52CFD153063CD0D2A78B43F8712243845E6F2CBA1DB610F403D │ │ │ │ │ +A98D06D95FF44C7AC029092B666A8B0DCEA95B34F5ACC10E8611BADE6A24469C │ │ │ │ │ +0C01D95BFB445FA22CD38D033E4D24E006BB9D54EE41EF7AD5AC9C299721F61A │ │ │ │ │ +F01B6EDCDF428BD9195A13C5B1027358F8A203F828A1DD9622243B2D76C6F1BA │ │ │ │ │ +9F2D7E9D4879FC668ABC750CD25415DC6CCF2257C28F78D3F9BE499CC0FF2F80 │ │ │ │ │ +2C2CD1DEFABD6668FCA76E1D629A344333E33DA24B86D2E9F8F5EE1C29974640 │ │ │ │ │ +C3E78E999BAB313400041DADDDFDBFFCC419F129A84F4D412B79E8BE4511CA00 │ │ │ │ │ +F92A4F3CDD2E51345D3965C104F06B6503445DC20224CB7606A9D7D5F9EE45E6 │ │ │ │ │ +1B2963DA96AA2AB1BA5BE29656E666E4D0E122DE58EEA68E04ED76438DA03E65 │ │ │ │ │ +B80055A86B7B2A26BAE6BBB8835E17F9696E9B3CD34571BA75C76D4D2CCC48F1 │ │ │ │ │ +7534C1EF9127E374D65D05B8072E08D6C72A0B4A35EA0DD717743C66D105CCD8 │ │ │ │ │ +7355F13E9C38C1A4351624E689ED7909100942FA0474842EE44DEC3279E1A1CD │ │ │ │ │ +8064666EB845CA7C3E906B67C0BF96A28D514DB2E4A1E4AF287350B03762A2CF │ │ │ │ │ +13B18AC3F5D2F3B74A1D50267C03EFB74B888E1D24ABEEA4A885F4D0BF14C0D8 │ │ │ │ │ +289AC79D6D98E2A2C831672FB1F3457564CD161ADC3AF610D88201AB5B0C10CB │ │ │ │ │ +5ECCC2D5C4AF39C8CB3044BF9EC791BA45D29C2B51EA0483D19822C264CE6FA3 │ │ │ │ │ +5C97F2DF5A78CB93528E99B9ED7CB121C83130C129B849B52A36EBD88AF19DD3 │ │ │ │ │ +C5CABE831027388EF86BD5CBD90AAAC089775938A321C44D4DDA67A51312D8AB │ │ │ │ │ +C509DDBE7044A107AB2BE9C4C9556F85C529B174A7778B489BF28EC07A834542 │ │ │ │ │ +8B31F2925C21FB2096877711F998763D5A8495002B8E080AF8DBB1B3106EDDBA │ │ │ │ │ +35121D52E0846A7AF3ABEDF87BDE4FA665673A9B80CA538B98F873947AA17EF4 │ │ │ │ │ +9BB182917E9D79BC7EC681E93710D6A1D6B0E4A7FA9452FC1C431808174F3AB7 │ │ │ │ │ +F3914FBC86CB34E8583457243C3C7BE4BC166C7397689BC6FFB82EA2967E88EE │ │ │ │ │ +464F96EDA144DE2B64401B8E577ABCA2D826FE0B92E21FFAE3E81EBB6B6EB36E │ │ │ │ │ +9B1A8FE3884CA398C03135FD49D51724FC1268E9482E41FAEA2FC6C809006B8F │ │ │ │ │ +5D4F9E038450AD3A6041C16FD1C7E5FC80C0E033CE57E64863E014531D94DF1E │ │ │ │ │ +31D7D038AFCB60715AA73C1E96F113A24C5AF35BBEB61C4D079ED034ED83AA4A │ │ │ │ │ +E12448E618330463304788BCF40561CD63167B3BF144F408E2B89E60B8BA13EF │ │ │ │ │ +3B57D286FD23D4FA8BAEFF98DC1188B1982956CC1DCAEFC7D949B7B4E3BE8F8A │ │ │ │ │ +BFE2C9D938DD13EFEE7123576608D9396F260907DA98AE2D3DD5822306CBC8A6 │ │ │ │ │ +B083C697DDA3C62EE7879436A9FD8EE0034B105105B3F122F893EA2126EBE8A9 │ │ │ │ │ +5CBF2BD248DD9FBEF0040C25797BD13B69A8C9F0D4E4F935C61ED30487CCDB1A │ │ │ │ │ +0339006E78EE1755929D2412776EC7DB1F666DBDD28EA8AC7397F809C7F38A41 │ │ │ │ │ +5B3BF6C75F4F35C90141EB08377AF452CF840FEA938805F9D14E02DC29215B4E │ │ │ │ │ +F1EB │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ @@ -3287,16 +3278,16 @@ │ │ │ │ │ 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 23[45 19[83 18[25 2[45 │ │ │ │ │ -2[45 1[45 45 45 3[25 44[{}10 90.9091 /CMSL10 rf │ │ │ │ │ +90.9091 /CMTI10 rf /Ff 138[51 6[51 8[40 26[47 15[25 4[45 │ │ │ │ │ +2[45 1[45 3[25 44[{}9 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 │ │ │ │ │ @@ -3407,17 +3398,17 @@ │ │ │ │ │ (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 1131 4 v │ │ │ │ │ -1313 w Fh(ChvList)29 b Ff(:)40 b Fe(DRAFT)30 b Ff(Ma)m(y)i(17,)f(2024)p │ │ │ │ │ -2769 100 V 0 399 a Fi(F)-8 b(or)35 b(a)g(m)m(ultithreaded)g │ │ │ │ │ +TeXDict begin 2 1 bop 0 100 a Fi(2)p 136 100 1124 4 v │ │ │ │ │ +1306 w Fh(ChvList)29 b Ff(:)40 b Fe(DRAFT)30 b Ff(June)g(20,)h(2025)p │ │ │ │ │ +2776 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 │ │ │ │ │ @@ -3470,17 +3461,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 1131 4 v 1313 100 a Fh(ChvList)28 │ │ │ │ │ -b Ff(:)41 b Fe(DRAFT)121 b Ff(Ma)m(y)31 b(17,)h(2024)p │ │ │ │ │ -2722 100 V 1131 w Fi(3)111 399 y(3.)46 b Fh(void)h(ChvList_clearData)c │ │ │ │ │ +TeXDict begin 3 2 bop 91 100 1124 4 v 1306 100 a Fh(ChvList)28 │ │ │ │ │ +b Ff(:)41 b Fe(DRAFT)121 b Ff(June)29 b(20,)j(2025)p │ │ │ │ │ +2729 100 V 1124 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 │ │ │ │ │ @@ -3543,17 +3534,17 @@ │ │ │ │ │ 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 1131 4 v │ │ │ │ │ -1313 w Fh(ChvList)29 b Ff(:)40 b Fe(DRAFT)30 b Ff(Ma)m(y)i(17,)f(2024)p │ │ │ │ │ -2769 100 V 111 399 a Fi(3.)46 b Fh(Chv)h(*)h(ChvList_getList)43 │ │ │ │ │ +TeXDict begin 4 3 bop 0 100 a Fi(4)p 136 100 1124 4 v │ │ │ │ │ +1306 w Fh(ChvList)29 b Ff(:)40 b Fe(DRAFT)30 b Ff(June)g(20,)h(2025)p │ │ │ │ │ +2776 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 │ │ │ │ │ ├── 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 May 17, 2024 │ │ │ │ │ │ + 2 ChvList : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 3 │ │ │ │ │ │ + ChvList : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 4 ChvList : DRAFT June 20, 2025 │ │ │ │ │ │ 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 2024.05.17:2217 │ │ │ │ │ +%DVIPSSource: TeX output 2025.06.20:0449 │ │ │ │ │ %%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 │ │ │ │ │ @@ -1157,22 +1157,21 @@ │ │ │ │ │ /UnderlinePosition -100 def │ │ │ │ │ /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 49 /one put │ │ │ │ │ dup 50 /two put │ │ │ │ │ -dup 52 /four put │ │ │ │ │ -dup 55 /seven put │ │ │ │ │ +dup 53 /five put │ │ │ │ │ dup 58 /colon put │ │ │ │ │ -dup 77 /M put │ │ │ │ │ -dup 97 /a put │ │ │ │ │ -dup 121 /y put │ │ │ │ │ +dup 74 /J put │ │ │ │ │ +dup 101 /e put │ │ │ │ │ +dup 110 /n put │ │ │ │ │ +dup 117 /u put │ │ │ │ │ readonly def │ │ │ │ │ currentdict end │ │ │ │ │ currentfile eexec │ │ │ │ │ D9D66F633B846AB284BCF8B0411B772DE5CE32340DC6F28AF40857E4451976E7 │ │ │ │ │ 5182433CF9F333A38BD841C0D4E68BF9E012EB32A8FFB76B5816306B5EDF7C99 │ │ │ │ │ 8B3A16D9B4BC056662E32C7CD0123DFAEB734C7532E64BBFBF5A60336E646716 │ │ │ │ │ EFB852C877F440D329172C71F1E5D59CE9473C26B8AEF7AD68EF0727B6EC2E0C │ │ │ │ │ @@ -1353,72 +1352,64 @@ │ │ │ │ │ 7CA1534C4D5B05FC33F83790ECFD7641DF3FB94289E2A1F6E7D29AB1228A867A │ │ │ │ │ 6E1EF0E9C6F899B491DC18401C2C0A05FFFED46A72C245F7529B8EA55A038082 │ │ │ │ │ 8512307217D2A233C37004085BA3AEE379269F9FA7D0ADB4B19A95CC2AFE686E │ │ │ │ │ 55D88E47257C1FE6F235FEA295910569FE6DD5995512562359CC821E85A6C7A5 │ │ │ │ │ 79B470A9E340A6985189FF8B6AF914A6B0ECF93F47903221F95DE894A8F05B05 │ │ │ │ │ B7D99CD533EC5F931B18E6B39BECF67FA2D6DD1AEC76772B068BE06335A94C05 │ │ │ │ │ 7A4DDEE77B66101DA855C17AC312600370B34E31F5EC3A01300A8EB60B4C9767 │ │ │ │ │ -1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004B9BA1CC │ │ │ │ │ -580D3C6BDA4DC1B80B4365F1C80512453FC5316EC2D928FB731C3D6403E3C18B │ │ │ │ │ -E8424D644DF5E9A2134229C5C91CA68DB8E85BA2BB40F538F585DA6FA4037718 │ │ │ │ │ -B8053EBBA1E765346BCD5BDAA6C38115D31611D8A87A2238C145F2DA2F92E4DF │ │ │ │ │ -3987BD9C4D2A3D460E8941A68B125BCD9EE4F9FD262C4C8A71F47A2C81975635 │ │ │ │ │ -F1B981C274C53FA2ACCDE4C9D0A7C62D6C1EFF91CFC6712CA6A9F333C9564FCB │ │ │ │ │ -2A70F0AD715A79B10A08AB069E2A3C93BC0AED19D0CA10134B8DDDE8AF548DB2 │ │ │ │ │ -3A4AAA9C29682CF135BB767DAA16169A127EB50A7EECEB6480CF56A7D0F8AC56 │ │ │ │ │ -4A5090B3D75A790372886AF568D94C8165975A05BFBFDF1FFBA45F70700BB9E0 │ │ │ │ │ -57F3249EF9E9C8AD9CBCF6E4FD592DC4CDD2CC7C0BC3130C1059096C657BE453 │ │ │ │ │ -A2CBACE93420210E27AF56CA229BD6D982FB68B3FDC6D44478B922C4231C47EE │ │ │ │ │ -E500232F6C11D92DEB955F66DF52B92B22E7352790CC2DCBAC53965D57AC2920 │ │ │ │ │ -68B7D520DE25047146EFEB06B9AD4E2A94243C7E5239F0BC2FC312B16051D52C │ │ │ │ │ -0B92C217B6B42997321AE4F8BB066754B7AA3F15069EF59224E8A442CE471AA7 │ │ │ │ │ -E8049A3DD9EDA09CCEE4998998661CF7DB35E952F6C65DAEB3013951C59F3E09 │ │ │ │ │ -157F313B0237876E1C0190F0473819570B8C0205AADF05D787CC00979CFB327A │ │ │ │ │ -289382B22DDA6F12804ED0ED5B179E36A995A2A59E1B66E75130DBE9109C813B │ │ │ │ │ -94403E0DEA8314A1E9DB474D7FA83C0BAFD08033E6A6215844C1D26BE15F1251 │ │ │ │ │ -A1605E8DF9A9C601ED37379530BC1C82BE5463C6C711C5652BFD6262485AA9CA │ │ │ │ │ -B8C4A117593001D08D980041E2A83C190DCE8E6CD3D334E5CC19FC05DB30F7F7 │ │ │ │ │ -24A305C4DBB31F0651392B99D44B4302333BDF7E326FD256DD75D309C6E73F85 │ │ │ │ │ -FA71B35FD1F9BEFF4C7A1076362EEB0A85492933B6006086A7B8C1928CF2D1EE │ │ │ │ │ -FD4344409257BB802C117E739960821CD3C88BFBA5669FF16F610AD638AF3677 │ │ │ │ │ -8674C985E6767253ED5769F71BEA5E9BB02A751F9E62EE2B18AC19D975FDEAE9 │ │ │ │ │ -8B8822367FF177A7E850766DE99ED3366D46464612926430012212A90F8E85F4 │ │ │ │ │ -4760B40D5B86B90819EE410382C23E86DCAF4F0FF5DFEB2C285965F4DCF2FB2B │ │ │ │ │ -457C0A0427A8D4ADA514E9DACD0F9367E1DA225DB21DA4DDAE33F2B529686D92 │ │ │ │ │ -AC085B345565F9DFFA012FD494DBB2E0B44A0787B2B72DC8D25399DAAE8864B7 │ │ │ │ │ -E84AA99DAFCEAF18F8B41882720316450F1B1CA48B418C9736E5CE4AFF996111 │ │ │ │ │ -5F7FE80958B6A3498508E9693CB134402D92E30D4C2939070D4647E13682290E │ │ │ │ │ -1D0820A3FCA7147157D09D1A40771F214EAE7DD743EA26839E535CA186C05CB8 │ │ │ │ │ -4874988AA1104D85AF0220FE7224344FF624E794BD2454E1C0AC971522FBECBA │ │ │ │ │ -B2497F25CD621B77EC5160973EF5ECC39C183DC051B0DFCB090194A2525BD96E │ │ │ │ │ -28593FDA80D8D259F039416D5F9AF0AD3C9A105B49DAF6E681921E369B7666C6 │ │ │ │ │ -2B73DB37447B00AE96317C2F1C44FB6E6EFD740BAB20FA03A8CE018EC8415582 │ │ │ │ │ -FB06E88A2971E3A480FB1EB4FE93CC7E5179721CAABEE88742B13CF0405F49F4 │ │ │ │ │ -945E587668C821D8C06D6847B6DF84CAFFCD4628670D551FC5F7236875BE1207 │ │ │ │ │ -634BA7F70A19B658FAE7D86F6D00ED28FBF29CC585DEE279325EEF8B0CCB6149 │ │ │ │ │ -E46E638C73D75148F18A636DBC2DD96ED34F68A5A09A3700B1EA34B2D142807C │ │ │ │ │ -F8709D81180783548EAE6F457BF968602076A1069163E3C15BBCEF659C6CF2E6 │ │ │ │ │ -0BB01BDC8E503802CC7969A5B8477E9788C5249B23B19669F5075E089738E49A │ │ │ │ │ -8671D7C1B1B47652F3D78BF2FF74EDB44BA5B092E8D5B85001E97F69D54AEEFC │ │ │ │ │ -88FC3CA1B0D5BAC39263B371005BCFA19AD197A31CC34D0BD55C2CA18C60C485 │ │ │ │ │ -5993F736EF1DD2C5D2B4D50B3D498861B4DF5E7AFF614BBCA4C2E6BECC0DCEF5 │ │ │ │ │ -95F0D686188014C530D8E37650CDCAE721B4AFB0F178BC744BDDDED45DAB7FEB │ │ │ │ │ -A10B975E26099E3DC61116D6BF554574F948895B88EEFE03DCC5351190836AD4 │ │ │ │ │ -EBC1AC55C6D099A8E7B0A372D290C481F44FA464B9C11A0BC991CB045E0AAAC4 │ │ │ │ │ -5C73CA43A4F17D1ADDD33D1B917FF95BFF411C8409F41553B1BC97DE47E3A1F4 │ │ │ │ │ -A5C1D1B7B1BF7E2507AC53956C141411F4F657E37981996DD7BB7ADB2CB6AE01 │ │ │ │ │ -73D0876B8F896F626D5022FE53BA34D5668BD698BE8D5CCAD083CBCEF440BE6A │ │ │ │ │ -8090EB1CDEE5F99C8988650BD4E539B357C31C597D8A9104A9D5967D4E906CAD │ │ │ │ │ -2A65575A884B1C5F6CC509E742FA9DDD66494F219178161AF72C50848E226A95 │ │ │ │ │ -A8C247FF9FF0BABD073021271B5C0692F9BE220071DAB09E5A026629371EE3C4 │ │ │ │ │ -A6E4FA94625D87A5B66EF077ED54C72B1052AEAA9637B30C76EF8EB04AD5F476 │ │ │ │ │ -D15F1C93C0BC6E0F67B366097BBED03FE82C040F9EF02866159B46854E11D44F │ │ │ │ │ -54AE6748A7E61B993A4EECD3B8BE3B5897A66BBCDFE24F65BC2AD5AB49048CF1 │ │ │ │ │ -647203823F84DF5CB483096F9D96AEE3A2855E479B72A14A67C633CE99C101CF │ │ │ │ │ -EFAE939BF9B02E710D │ │ │ │ │ +1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004ACD1870 │ │ │ │ │ +A5EA947858F5795870BFE1343AD803FB854BF8F5A4E794E8EC57BE41DB5B8734 │ │ │ │ │ +13E47950F29A81EA0C81EA798863883D7F41F78325CA190CBBFFE822AE494550 │ │ │ │ │ +4BE83703071FC9512D128927AF3F63CEF8F86ABE1E15D7B4DDD39576E7DFF45E │ │ │ │ │ +3CB4115AAB1830DE8647B915DB4BEBEB5235C281E098B899BAB951D8D5798F01 │ │ │ │ │ +7F7C47336D31438E5126738AFEAB29E9A7CBE06DE4DD604477B542D2620DFD58 │ │ │ │ │ +28FE34238572F23C5A8EB7ACEE1E154DA13FC1A5AA67A3BA8C5CDFB2B80312C9 │ │ │ │ │ +BC9FAE56D08DDFA9498E6EF0D0F6BD18B3923E0B670B0740528BC843610736CB │ │ │ │ │ +80228C105C2F72C3C22D610C3D8C268DEEA2AEEE3221E198E79FE2966487360C │ │ │ │ │ +84AE08AC326F48B21447652121B1EB68AF856055EEA65B6B625BF622CBFC2D1C │ │ │ │ │ +EF943CC4CAF2C715782C9EF9A9BA4689BFC6B6A82F8D55795BE8111E2C7DE520 │ │ │ │ │ +367362304B6A48186C842033E715A46265A352472F4F7313248EBCD26BEA97E7 │ │ │ │ │ +B814A61D4B7ADCB5C5F21AA34E0C1269E8426DBFB511DE6E26B960456C8F8520 │ │ │ │ │ +5F0DD382289A62AF0B935EDB5B2394538C5F0EE72962D2F98F3C38CD7C027B9F │ │ │ │ │ +E230E67E40FEFBDED06B3423C9DFD669E6B5BC913E0FF75786A64A6C11D4FE89 │ │ │ │ │ +1B918DC0E953C52CFD153063CD0D2A78B43F8712243845E6F2CBA1DB610F403D │ │ │ │ │ +A98D06D95FF44C7AC029092B666A8B0DCEA95B34F5ACC10E8611BADE6A24469C │ │ │ │ │ +0C01D95BFB445FA22CD38D033E4D24E006BB9D54EE41EF7AD5AC9C299721F61A │ │ │ │ │ +F01B6EDCDF428BD9195A13C5B1027358F8A203F828A1DD9622243B2D76C6F1BA │ │ │ │ │ +9F2D7E9D4879FC668ABC750CD25415DC6CCF2257C28F78D3F9BE499CC0FF2F80 │ │ │ │ │ +2C2CD1DEFABD6668FCA76E1D629A344333E33DA24B86D2E9F8F5EE1C29974640 │ │ │ │ │ +C3E78E999BAB313400041DADDDFDBFFCC419F129A84F4D412B79E8BE4511CA00 │ │ │ │ │ +F92A4F3CDD2E51345D3965C104F06B6503445DC20224CB7606A9D7D5F9EE45E6 │ │ │ │ │ +1B2963DA96AA2AB1BA5BE29656E666E4D0E122DE58EEA68E04ED76438DA03E65 │ │ │ │ │ +B80055A86B7B2A26BAE6BBB8835E17F9696E9B3CD34571BA75C76D4D2CCC48F1 │ │ │ │ │ +7534C1EF9127E374D65D05B8072E08D6C72A0B4A35EA0DD717743C66D105CCD8 │ │ │ │ │ +7355F13E9C38C1A4351624E689ED7909100942FA0474842EE44DEC3279E1A1CD │ │ │ │ │ +8064666EB845CA7C3E906B67C0BF96A28D514DB2E4A1E4AF287350B03762A2CF │ │ │ │ │ +13B18AC3F5D2F3B74A1D50267C03EFB74B888E1D24ABEEA4A885F4D0BF14C0D8 │ │ │ │ │ +289AC79D6D98E2A2C831672FB1F3457564CD161ADC3AF610D88201AB5B0C10CB │ │ │ │ │ +5ECCC2D5C4AF39C8CB3044BF9EC791BA45D29C2B51EA0483D19822C264CE6FA3 │ │ │ │ │ +5C97F2DF5A78CB93528E99B9ED7CB121C83130C129B849B52A36EBD88AF19DD3 │ │ │ │ │ +C5CABE831027388EF86BD5CBD90AAAC089775938A321C44D4DDA67A51312D8AB │ │ │ │ │ +C509DDBE7044A107AB2BE9C4C9556F85C529B174A7778B489BF28EC07A834542 │ │ │ │ │ +8B31F2925C21FB2096877711F998763D5A8495002B8E080AF8DBB1B3106EDDBA │ │ │ │ │ +35121D52E0846A7AF3ABEDF87BDE4FA665673A9B80CA538B98F873947AA17EF4 │ │ │ │ │ +9BB182917E9D79BC7EC681E93710D6A1D6B0E4A7FA9452FC1C431808174F3AB7 │ │ │ │ │ +F3914FBC86CB34E8583457243C3C7BE4BC166C7397689BC6FFB82EA2967E88EE │ │ │ │ │ +464F96EDA144DE2B64401B8E577ABCA2D826FE0B92E21FFAE3E81EBB6B6EB36E │ │ │ │ │ +9B1A8FE3884CA398C03135FD49D51724FC1268E9482E41FAEA2FC6C809006B8F │ │ │ │ │ +5D4F9E038450AD3A6041C16FD1C7E5FC80C0E033CE57E64863E014531D94DF1E │ │ │ │ │ +31D7D038AFCB60715AA73C1E96F113A24C5AF35BBEB61C4D079ED034ED83AA4A │ │ │ │ │ +E12448E618330463304788BCF40561CD63167B3BF144F408E2B89E60B8BA13EF │ │ │ │ │ +3B57D286FD23D4FA8BAEFF98DC1188B1982956CC1DCAEFC7D949B7B4E3BE8F8A │ │ │ │ │ +BFE2C9D938DD13EFEE7123576608D9396F260907DA98AE2D3DD5822306CBC8A6 │ │ │ │ │ +B083C697DDA3C62EE7879436A9FD8EE0034B105105B3F122F893EA2126EBE8A9 │ │ │ │ │ +5CBF2BD248DD9FBEF0040C25797BD13B69A8C9F0D4E4F935C61ED30487CCDB1A │ │ │ │ │ +0339006E78EE1755929D2412776EC7DB1F666DBDD28EA8AC7397F809C7F38A41 │ │ │ │ │ +5B3BF6C75F4F35C90141EB08377AF452CF840FEA938805F9D14E02DC29215B4E │ │ │ │ │ +F1EB │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ @@ -3089,18 +3080,18 @@ │ │ │ │ │ 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 23[45 19[83 18[25 2[45 2[45 1[45 45 45 │ │ │ │ │ -3[25 44[{}10 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 │ │ │ │ │ +rf /Fd 138[51 6[51 8[40 26[47 15[25 4[45 2[45 1[45 3[25 │ │ │ │ │ +44[{}9 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 │ │ │ │ │ /afii61664.cap/arrowleft/arrowright/tieaccentlowercase/tieaccentcapital │ │ │ │ │ /tieaccentlowercase.new/tieaccentcapital.new/.notdef/afii61664.asc/uni2422 3 │ │ │ │ │ {/.notdef}repeat/dollar/.notdef/.notdef/quotesingle/.notdef/.notdef │ │ │ │ │ @@ -3217,17 +3208,17 @@ │ │ │ │ │ (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 1107 4 v │ │ │ │ │ -1289 w Fg(DChvList)28 b Fd(:)41 b Fe(DRAFT)30 b Fd(Ma)m(y)i(17,)f(2024) │ │ │ │ │ -p 2793 100 V 0 399 a Fh(requires)f(that)i(a)f(lo)s(c)m(k)h(b)s(e)e │ │ │ │ │ +TeXDict begin 2 1 bop 0 100 a Fh(2)p 136 100 1101 4 v │ │ │ │ │ +1282 w Fg(DChvList)28 b Fd(:)41 b Fe(DRAFT)30 b Fd(June)g(20,)h(2025)p │ │ │ │ │ +2800 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 │ │ │ │ │ @@ -3280,17 +3271,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 1107 4 v 1289 100 a Fg(DChvList)28 │ │ │ │ │ -b Fd(:)41 b Fe(DRAFT)121 b Fd(Ma)m(y)31 b(17,)h(2024)p │ │ │ │ │ -2746 100 V 1107 w Fh(3)111 399 y(2.)46 b Fg(void)h │ │ │ │ │ +TeXDict begin 3 2 bop 91 100 1101 4 v 1282 100 a Fg(DChvList)28 │ │ │ │ │ +b Fd(:)41 b Fe(DRAFT)121 b Fd(June)29 b(20,)j(2025)p │ │ │ │ │ +2753 100 V 1101 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 │ │ │ │ │ @@ -3357,17 +3348,17 @@ │ │ │ │ │ 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 1107 4 v │ │ │ │ │ -1289 w Fg(DChvList)28 b Fd(:)41 b Fe(DRAFT)30 b Fd(Ma)m(y)i(17,)f(2024) │ │ │ │ │ -p 2793 100 V 0 399 a Fa(1.2.4)112 b(IO)38 b(metho)s(ds)111 │ │ │ │ │ +TeXDict begin 4 3 bop 0 100 a Fh(4)p 136 100 1101 4 v │ │ │ │ │ +1282 w Fg(DChvList)28 b Fd(:)41 b Fe(DRAFT)30 b Fd(June)g(20,)h(2025)p │ │ │ │ │ +2800 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 │ │ │ │ │ ├── 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 May 17, 2024 │ │ │ │ │ │ + 2 DChvList : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 3 │ │ │ │ │ │ + DChvList : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 4 DChvList : DRAFT June 20, 2025 │ │ │ │ │ │ 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 2024.05.17:2217 │ │ │ │ │ +%DVIPSSource: TeX output 2025.06.20:0449 │ │ │ │ │ %%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 │ │ │ │ │ @@ -1236,22 +1236,21 @@ │ │ │ │ │ /UnderlinePosition -100 def │ │ │ │ │ /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 49 /one put │ │ │ │ │ dup 50 /two put │ │ │ │ │ -dup 52 /four put │ │ │ │ │ -dup 55 /seven put │ │ │ │ │ +dup 53 /five put │ │ │ │ │ dup 58 /colon put │ │ │ │ │ -dup 77 /M put │ │ │ │ │ -dup 97 /a put │ │ │ │ │ -dup 121 /y put │ │ │ │ │ +dup 74 /J put │ │ │ │ │ +dup 101 /e put │ │ │ │ │ +dup 110 /n put │ │ │ │ │ +dup 117 /u put │ │ │ │ │ readonly def │ │ │ │ │ currentdict end │ │ │ │ │ currentfile eexec │ │ │ │ │ D9D66F633B846AB284BCF8B0411B772DE5CE32340DC6F28AF40857E4451976E7 │ │ │ │ │ 5182433CF9F333A38BD841C0D4E68BF9E012EB32A8FFB76B5816306B5EDF7C99 │ │ │ │ │ 8B3A16D9B4BC056662E32C7CD0123DFAEB734C7532E64BBFBF5A60336E646716 │ │ │ │ │ EFB852C877F440D329172C71F1E5D59CE9473C26B8AEF7AD68EF0727B6EC2E0C │ │ │ │ │ @@ -1432,72 +1431,64 @@ │ │ │ │ │ 7CA1534C4D5B05FC33F83790ECFD7641DF3FB94289E2A1F6E7D29AB1228A867A │ │ │ │ │ 6E1EF0E9C6F899B491DC18401C2C0A05FFFED46A72C245F7529B8EA55A038082 │ │ │ │ │ 8512307217D2A233C37004085BA3AEE379269F9FA7D0ADB4B19A95CC2AFE686E │ │ │ │ │ 55D88E47257C1FE6F235FEA295910569FE6DD5995512562359CC821E85A6C7A5 │ │ │ │ │ 79B470A9E340A6985189FF8B6AF914A6B0ECF93F47903221F95DE894A8F05B05 │ │ │ │ │ B7D99CD533EC5F931B18E6B39BECF67FA2D6DD1AEC76772B068BE06335A94C05 │ │ │ │ │ 7A4DDEE77B66101DA855C17AC312600370B34E31F5EC3A01300A8EB60B4C9767 │ │ │ │ │ -1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004B9BA1CC │ │ │ │ │ -580D3C6BDA4DC1B80B4365F1C80512453FC5316EC2D928FB731C3D6403E3C18B │ │ │ │ │ -E8424D644DF5E9A2134229C5C91CA68DB8E85BA2BB40F538F585DA6FA4037718 │ │ │ │ │ -B8053EBBA1E765346BCD5BDAA6C38115D31611D8A87A2238C145F2DA2F92E4DF │ │ │ │ │ -3987BD9C4D2A3D460E8941A68B125BCD9EE4F9FD262C4C8A71F47A2C81975635 │ │ │ │ │ -F1B981C274C53FA2ACCDE4C9D0A7C62D6C1EFF91CFC6712CA6A9F333C9564FCB │ │ │ │ │ -2A70F0AD715A79B10A08AB069E2A3C93BC0AED19D0CA10134B8DDDE8AF548DB2 │ │ │ │ │ -3A4AAA9C29682CF135BB767DAA16169A127EB50A7EECEB6480CF56A7D0F8AC56 │ │ │ │ │ -4A5090B3D75A790372886AF568D94C8165975A05BFBFDF1FFBA45F70700BB9E0 │ │ │ │ │ -57F3249EF9E9C8AD9CBCF6E4FD592DC4CDD2CC7C0BC3130C1059096C657BE453 │ │ │ │ │ -A2CBACE93420210E27AF56CA229BD6D982FB68B3FDC6D44478B922C4231C47EE │ │ │ │ │ -E500232F6C11D92DEB955F66DF52B92B22E7352790CC2DCBAC53965D57AC2920 │ │ │ │ │ -68B7D520DE25047146EFEB06B9AD4E2A94243C7E5239F0BC2FC312B16051D52C │ │ │ │ │ -0B92C217B6B42997321AE4F8BB066754B7AA3F15069EF59224E8A442CE471AA7 │ │ │ │ │ -E8049A3DD9EDA09CCEE4998998661CF7DB35E952F6C65DAEB3013951C59F3E09 │ │ │ │ │ -157F313B0237876E1C0190F0473819570B8C0205AADF05D787CC00979CFB327A │ │ │ │ │ -289382B22DDA6F12804ED0ED5B179E36A995A2A59E1B66E75130DBE9109C813B │ │ │ │ │ -94403E0DEA8314A1E9DB474D7FA83C0BAFD08033E6A6215844C1D26BE15F1251 │ │ │ │ │ -A1605E8DF9A9C601ED37379530BC1C82BE5463C6C711C5652BFD6262485AA9CA │ │ │ │ │ -B8C4A117593001D08D980041E2A83C190DCE8E6CD3D334E5CC19FC05DB30F7F7 │ │ │ │ │ -24A305C4DBB31F0651392B99D44B4302333BDF7E326FD256DD75D309C6E73F85 │ │ │ │ │ -FA71B35FD1F9BEFF4C7A1076362EEB0A85492933B6006086A7B8C1928CF2D1EE │ │ │ │ │ -FD4344409257BB802C117E739960821CD3C88BFBA5669FF16F610AD638AF3677 │ │ │ │ │ -8674C985E6767253ED5769F71BEA5E9BB02A751F9E62EE2B18AC19D975FDEAE9 │ │ │ │ │ -8B8822367FF177A7E850766DE99ED3366D46464612926430012212A90F8E85F4 │ │ │ │ │ -4760B40D5B86B90819EE410382C23E86DCAF4F0FF5DFEB2C285965F4DCF2FB2B │ │ │ │ │ -457C0A0427A8D4ADA514E9DACD0F9367E1DA225DB21DA4DDAE33F2B529686D92 │ │ │ │ │ -AC085B345565F9DFFA012FD494DBB2E0B44A0787B2B72DC8D25399DAAE8864B7 │ │ │ │ │ -E84AA99DAFCEAF18F8B41882720316450F1B1CA48B418C9736E5CE4AFF996111 │ │ │ │ │ -5F7FE80958B6A3498508E9693CB134402D92E30D4C2939070D4647E13682290E │ │ │ │ │ -1D0820A3FCA7147157D09D1A40771F214EAE7DD743EA26839E535CA186C05CB8 │ │ │ │ │ -4874988AA1104D85AF0220FE7224344FF624E794BD2454E1C0AC971522FBECBA │ │ │ │ │ -B2497F25CD621B77EC5160973EF5ECC39C183DC051B0DFCB090194A2525BD96E │ │ │ │ │ -28593FDA80D8D259F039416D5F9AF0AD3C9A105B49DAF6E681921E369B7666C6 │ │ │ │ │ -2B73DB37447B00AE96317C2F1C44FB6E6EFD740BAB20FA03A8CE018EC8415582 │ │ │ │ │ -FB06E88A2971E3A480FB1EB4FE93CC7E5179721CAABEE88742B13CF0405F49F4 │ │ │ │ │ -945E587668C821D8C06D6847B6DF84CAFFCD4628670D551FC5F7236875BE1207 │ │ │ │ │ -634BA7F70A19B658FAE7D86F6D00ED28FBF29CC585DEE279325EEF8B0CCB6149 │ │ │ │ │ -E46E638C73D75148F18A636DBC2DD96ED34F68A5A09A3700B1EA34B2D142807C │ │ │ │ │ -F8709D81180783548EAE6F457BF968602076A1069163E3C15BBCEF659C6CF2E6 │ │ │ │ │ -0BB01BDC8E503802CC7969A5B8477E9788C5249B23B19669F5075E089738E49A │ │ │ │ │ -8671D7C1B1B47652F3D78BF2FF74EDB44BA5B092E8D5B85001E97F69D54AEEFC │ │ │ │ │ -88FC3CA1B0D5BAC39263B371005BCFA19AD197A31CC34D0BD55C2CA18C60C485 │ │ │ │ │ -5993F736EF1DD2C5D2B4D50B3D498861B4DF5E7AFF614BBCA4C2E6BECC0DCEF5 │ │ │ │ │ -95F0D686188014C530D8E37650CDCAE721B4AFB0F178BC744BDDDED45DAB7FEB │ │ │ │ │ -A10B975E26099E3DC61116D6BF554574F948895B88EEFE03DCC5351190836AD4 │ │ │ │ │ -EBC1AC55C6D099A8E7B0A372D290C481F44FA464B9C11A0BC991CB045E0AAAC4 │ │ │ │ │ -5C73CA43A4F17D1ADDD33D1B917FF95BFF411C8409F41553B1BC97DE47E3A1F4 │ │ │ │ │ -A5C1D1B7B1BF7E2507AC53956C141411F4F657E37981996DD7BB7ADB2CB6AE01 │ │ │ │ │ -73D0876B8F896F626D5022FE53BA34D5668BD698BE8D5CCAD083CBCEF440BE6A │ │ │ │ │ -8090EB1CDEE5F99C8988650BD4E539B357C31C597D8A9104A9D5967D4E906CAD │ │ │ │ │ -2A65575A884B1C5F6CC509E742FA9DDD66494F219178161AF72C50848E226A95 │ │ │ │ │ -A8C247FF9FF0BABD073021271B5C0692F9BE220071DAB09E5A026629371EE3C4 │ │ │ │ │ -A6E4FA94625D87A5B66EF077ED54C72B1052AEAA9637B30C76EF8EB04AD5F476 │ │ │ │ │ -D15F1C93C0BC6E0F67B366097BBED03FE82C040F9EF02866159B46854E11D44F │ │ │ │ │ -54AE6748A7E61B993A4EECD3B8BE3B5897A66BBCDFE24F65BC2AD5AB49048CF1 │ │ │ │ │ -647203823F84DF5CB483096F9D96AEE3A2855E479B72A14A67C633CE99C101CF │ │ │ │ │ -EFAE939BF9B02E710D │ │ │ │ │ +1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004ACD1870 │ │ │ │ │ +A5EA947858F5795870BFE1343AD803FB854BF8F5A4E794E8EC57BE41DB5B8734 │ │ │ │ │ +13E47950F29A81EA0C81EA798863883D7F41F78325CA190CBBFFE822AE494550 │ │ │ │ │ +4BE83703071FC9512D128927AF3F63CEF8F86ABE1E15D7B4DDD39576E7DFF45E │ │ │ │ │ +3CB4115AAB1830DE8647B915DB4BEBEB5235C281E098B899BAB951D8D5798F01 │ │ │ │ │ +7F7C47336D31438E5126738AFEAB29E9A7CBE06DE4DD604477B542D2620DFD58 │ │ │ │ │ +28FE34238572F23C5A8EB7ACEE1E154DA13FC1A5AA67A3BA8C5CDFB2B80312C9 │ │ │ │ │ +BC9FAE56D08DDFA9498E6EF0D0F6BD18B3923E0B670B0740528BC843610736CB │ │ │ │ │ +80228C105C2F72C3C22D610C3D8C268DEEA2AEEE3221E198E79FE2966487360C │ │ │ │ │ +84AE08AC326F48B21447652121B1EB68AF856055EEA65B6B625BF622CBFC2D1C │ │ │ │ │ +EF943CC4CAF2C715782C9EF9A9BA4689BFC6B6A82F8D55795BE8111E2C7DE520 │ │ │ │ │ +367362304B6A48186C842033E715A46265A352472F4F7313248EBCD26BEA97E7 │ │ │ │ │ +B814A61D4B7ADCB5C5F21AA34E0C1269E8426DBFB511DE6E26B960456C8F8520 │ │ │ │ │ +5F0DD382289A62AF0B935EDB5B2394538C5F0EE72962D2F98F3C38CD7C027B9F │ │ │ │ │ +E230E67E40FEFBDED06B3423C9DFD669E6B5BC913E0FF75786A64A6C11D4FE89 │ │ │ │ │ +1B918DC0E953C52CFD153063CD0D2A78B43F8712243845E6F2CBA1DB610F403D │ │ │ │ │ +A98D06D95FF44C7AC029092B666A8B0DCEA95B34F5ACC10E8611BADE6A24469C │ │ │ │ │ +0C01D95BFB445FA22CD38D033E4D24E006BB9D54EE41EF7AD5AC9C299721F61A │ │ │ │ │ +F01B6EDCDF428BD9195A13C5B1027358F8A203F828A1DD9622243B2D76C6F1BA │ │ │ │ │ +9F2D7E9D4879FC668ABC750CD25415DC6CCF2257C28F78D3F9BE499CC0FF2F80 │ │ │ │ │ +2C2CD1DEFABD6668FCA76E1D629A344333E33DA24B86D2E9F8F5EE1C29974640 │ │ │ │ │ +C3E78E999BAB313400041DADDDFDBFFCC419F129A84F4D412B79E8BE4511CA00 │ │ │ │ │ +F92A4F3CDD2E51345D3965C104F06B6503445DC20224CB7606A9D7D5F9EE45E6 │ │ │ │ │ +1B2963DA96AA2AB1BA5BE29656E666E4D0E122DE58EEA68E04ED76438DA03E65 │ │ │ │ │ +B80055A86B7B2A26BAE6BBB8835E17F9696E9B3CD34571BA75C76D4D2CCC48F1 │ │ │ │ │ +7534C1EF9127E374D65D05B8072E08D6C72A0B4A35EA0DD717743C66D105CCD8 │ │ │ │ │ +7355F13E9C38C1A4351624E689ED7909100942FA0474842EE44DEC3279E1A1CD │ │ │ │ │ +8064666EB845CA7C3E906B67C0BF96A28D514DB2E4A1E4AF287350B03762A2CF │ │ │ │ │ +13B18AC3F5D2F3B74A1D50267C03EFB74B888E1D24ABEEA4A885F4D0BF14C0D8 │ │ │ │ │ +289AC79D6D98E2A2C831672FB1F3457564CD161ADC3AF610D88201AB5B0C10CB │ │ │ │ │ +5ECCC2D5C4AF39C8CB3044BF9EC791BA45D29C2B51EA0483D19822C264CE6FA3 │ │ │ │ │ +5C97F2DF5A78CB93528E99B9ED7CB121C83130C129B849B52A36EBD88AF19DD3 │ │ │ │ │ +C5CABE831027388EF86BD5CBD90AAAC089775938A321C44D4DDA67A51312D8AB │ │ │ │ │ +C509DDBE7044A107AB2BE9C4C9556F85C529B174A7778B489BF28EC07A834542 │ │ │ │ │ +8B31F2925C21FB2096877711F998763D5A8495002B8E080AF8DBB1B3106EDDBA │ │ │ │ │ +35121D52E0846A7AF3ABEDF87BDE4FA665673A9B80CA538B98F873947AA17EF4 │ │ │ │ │ +9BB182917E9D79BC7EC681E93710D6A1D6B0E4A7FA9452FC1C431808174F3AB7 │ │ │ │ │ +F3914FBC86CB34E8583457243C3C7BE4BC166C7397689BC6FFB82EA2967E88EE │ │ │ │ │ +464F96EDA144DE2B64401B8E577ABCA2D826FE0B92E21FFAE3E81EBB6B6EB36E │ │ │ │ │ +9B1A8FE3884CA398C03135FD49D51724FC1268E9482E41FAEA2FC6C809006B8F │ │ │ │ │ +5D4F9E038450AD3A6041C16FD1C7E5FC80C0E033CE57E64863E014531D94DF1E │ │ │ │ │ +31D7D038AFCB60715AA73C1E96F113A24C5AF35BBEB61C4D079ED034ED83AA4A │ │ │ │ │ +E12448E618330463304788BCF40561CD63167B3BF144F408E2B89E60B8BA13EF │ │ │ │ │ +3B57D286FD23D4FA8BAEFF98DC1188B1982956CC1DCAEFC7D949B7B4E3BE8F8A │ │ │ │ │ +BFE2C9D938DD13EFEE7123576608D9396F260907DA98AE2D3DD5822306CBC8A6 │ │ │ │ │ +B083C697DDA3C62EE7879436A9FD8EE0034B105105B3F122F893EA2126EBE8A9 │ │ │ │ │ +5CBF2BD248DD9FBEF0040C25797BD13B69A8C9F0D4E4F935C61ED30487CCDB1A │ │ │ │ │ +0339006E78EE1755929D2412776EC7DB1F666DBDD28EA8AC7397F809C7F38A41 │ │ │ │ │ +5B3BF6C75F4F35C90141EB08377AF452CF840FEA938805F9D14E02DC29215B4E │ │ │ │ │ +F1EB │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ @@ -3877,16 +3868,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 23[45 19[83 18[25 2[45 2[45 1[45 45 45 3[25 │ │ │ │ │ -44[{}10 90.9091 /CMSL10 rf /Fd 133[50 59 4[44 44 46 2[56 │ │ │ │ │ +/Fc 138[51 6[51 8[40 26[47 15[25 4[45 2[45 1[45 3[25 │ │ │ │ │ +44[{}9 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 │ │ │ │ │ @@ -3992,17 +3983,17 @@ │ │ │ │ │ (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 1155 4 v │ │ │ │ │ -1337 w Fj(Coords)29 b Fc(:)40 b Fb(DRAFT)31 b Fc(Ma)m(y)g(17,)h(2024)p │ │ │ │ │ -2745 100 V 111 399 a Fk(1.)46 b Fj(Coords)g(*)i(Coords_new)d(\()i(void) │ │ │ │ │ +TeXDict begin 2 1 bop 0 100 a Fk(2)p 136 100 1148 4 v │ │ │ │ │ +1330 w Fj(Coords)29 b Fc(:)40 b Fb(DRAFT)31 b Fc(June)e(20,)i(2025)p │ │ │ │ │ +2752 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 │ │ │ │ │ @@ -4071,17 +4062,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 1155 4 v 1337 100 a Fj(Coords)28 │ │ │ │ │ -b Fc(:)41 b Fb(DRAFT)121 b Fc(Ma)m(y)32 b(17,)f(2024)p │ │ │ │ │ -2698 100 V 1155 w Fk(3)227 399 y(This)g(metho)s(d)g(initializes)i(a)f │ │ │ │ │ +TeXDict begin 3 2 bop 91 100 1148 4 v 1330 100 a Fj(Coords)28 │ │ │ │ │ +b Fc(:)41 b Fb(DRAFT)121 b Fc(June)29 b(20,)j(2025)p │ │ │ │ │ +2705 100 V 1148 w Fk(3)227 399 y(This)f(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 │ │ │ │ │ @@ -4162,17 +4153,17 @@ │ │ │ │ │ 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 1155 4 v │ │ │ │ │ -1337 w Fj(Coords)29 b Fc(:)40 b Fb(DRAFT)31 b Fc(Ma)m(y)g(17,)h(2024)p │ │ │ │ │ -2745 100 V 227 399 a Fb(Err)-5 b(or)34 b(che)-5 b(cking:)40 │ │ │ │ │ +TeXDict begin 4 3 bop 0 100 a Fk(4)p 136 100 1148 4 v │ │ │ │ │ +1330 w Fj(Coords)29 b Fc(:)40 b Fb(DRAFT)31 b Fc(June)e(20,)i(2025)p │ │ │ │ │ +2752 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 │ │ │ │ │ @@ -4249,17 +4240,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 1155 4 v 1337 100 a Fj(Coords)28 │ │ │ │ │ -b Fc(:)41 b Fb(DRAFT)121 b Fc(Ma)m(y)32 b(17,)f(2024)p │ │ │ │ │ -2698 100 V 1155 w Fk(5)111 399 y(7.)46 b Fj(int)h │ │ │ │ │ +TeXDict begin 5 4 bop 91 100 1148 4 v 1330 100 a Fj(Coords)28 │ │ │ │ │ +b Fc(:)41 b Fb(DRAFT)121 b Fc(June)29 b(20,)j(2025)p │ │ │ │ │ +2705 100 V 1148 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 │ │ │ │ │ @@ -4323,17 +4314,17 @@ │ │ │ │ │ 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 1155 4 v │ │ │ │ │ -1337 w Fj(Coords)29 b Fc(:)40 b Fb(DRAFT)31 b Fc(Ma)m(y)g(17,)h(2024)p │ │ │ │ │ -2745 100 V 337 399 a Fg(\210)45 b Fk(The)20 b Fj(outCoordsFile)d │ │ │ │ │ +TeXDict begin 6 5 bop 0 100 a Fk(6)p 136 100 1148 4 v │ │ │ │ │ +1330 w Fj(Coords)29 b Fc(:)40 b Fb(DRAFT)31 b Fc(June)e(20,)i(2025)p │ │ │ │ │ +2752 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 │ │ │ │ │ ├── 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 May 17, 2024 │ │ │ │ │ │ + 2 Coords : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 3 │ │ │ │ │ │ + Coords : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 4 Coords : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 5 │ │ │ │ │ │ + Coords : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 6 Coords : DRAFT June 20, 2025 │ │ │ │ │ │ • 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 2024.05.17:2217 │ │ │ │ │ +%DVIPSSource: TeX output 2025.06.20:0449 │ │ │ │ │ %%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,22 +1406,21 @@ │ │ │ │ │ /UnderlinePosition -100 def │ │ │ │ │ /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 49 /one put │ │ │ │ │ dup 50 /two put │ │ │ │ │ -dup 52 /four put │ │ │ │ │ -dup 55 /seven put │ │ │ │ │ +dup 53 /five put │ │ │ │ │ dup 58 /colon put │ │ │ │ │ -dup 77 /M put │ │ │ │ │ -dup 97 /a put │ │ │ │ │ -dup 121 /y put │ │ │ │ │ +dup 74 /J put │ │ │ │ │ +dup 101 /e put │ │ │ │ │ +dup 110 /n put │ │ │ │ │ +dup 117 /u put │ │ │ │ │ readonly def │ │ │ │ │ currentdict end │ │ │ │ │ currentfile eexec │ │ │ │ │ D9D66F633B846AB284BCF8B0411B772DE5CE32340DC6F28AF40857E4451976E7 │ │ │ │ │ 5182433CF9F333A38BD841C0D4E68BF9E012EB32A8FFB76B5816306B5EDF7C99 │ │ │ │ │ 8B3A16D9B4BC056662E32C7CD0123DFAEB734C7532E64BBFBF5A60336E646716 │ │ │ │ │ EFB852C877F440D329172C71F1E5D59CE9473C26B8AEF7AD68EF0727B6EC2E0C │ │ │ │ │ @@ -1602,72 +1601,64 @@ │ │ │ │ │ 7CA1534C4D5B05FC33F83790ECFD7641DF3FB94289E2A1F6E7D29AB1228A867A │ │ │ │ │ 6E1EF0E9C6F899B491DC18401C2C0A05FFFED46A72C245F7529B8EA55A038082 │ │ │ │ │ 8512307217D2A233C37004085BA3AEE379269F9FA7D0ADB4B19A95CC2AFE686E │ │ │ │ │ 55D88E47257C1FE6F235FEA295910569FE6DD5995512562359CC821E85A6C7A5 │ │ │ │ │ 79B470A9E340A6985189FF8B6AF914A6B0ECF93F47903221F95DE894A8F05B05 │ │ │ │ │ B7D99CD533EC5F931B18E6B39BECF67FA2D6DD1AEC76772B068BE06335A94C05 │ │ │ │ │ 7A4DDEE77B66101DA855C17AC312600370B34E31F5EC3A01300A8EB60B4C9767 │ │ │ │ │ -1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004B9BA1CC │ │ │ │ │ -580D3C6BDA4DC1B80B4365F1C80512453FC5316EC2D928FB731C3D6403E3C18B │ │ │ │ │ -E8424D644DF5E9A2134229C5C91CA68DB8E85BA2BB40F538F585DA6FA4037718 │ │ │ │ │ -B8053EBBA1E765346BCD5BDAA6C38115D31611D8A87A2238C145F2DA2F92E4DF │ │ │ │ │ -3987BD9C4D2A3D460E8941A68B125BCD9EE4F9FD262C4C8A71F47A2C81975635 │ │ │ │ │ -F1B981C274C53FA2ACCDE4C9D0A7C62D6C1EFF91CFC6712CA6A9F333C9564FCB │ │ │ │ │ -2A70F0AD715A79B10A08AB069E2A3C93BC0AED19D0CA10134B8DDDE8AF548DB2 │ │ │ │ │ -3A4AAA9C29682CF135BB767DAA16169A127EB50A7EECEB6480CF56A7D0F8AC56 │ │ │ │ │ -4A5090B3D75A790372886AF568D94C8165975A05BFBFDF1FFBA45F70700BB9E0 │ │ │ │ │ -57F3249EF9E9C8AD9CBCF6E4FD592DC4CDD2CC7C0BC3130C1059096C657BE453 │ │ │ │ │ -A2CBACE93420210E27AF56CA229BD6D982FB68B3FDC6D44478B922C4231C47EE │ │ │ │ │ -E500232F6C11D92DEB955F66DF52B92B22E7352790CC2DCBAC53965D57AC2920 │ │ │ │ │ -68B7D520DE25047146EFEB06B9AD4E2A94243C7E5239F0BC2FC312B16051D52C │ │ │ │ │ -0B92C217B6B42997321AE4F8BB066754B7AA3F15069EF59224E8A442CE471AA7 │ │ │ │ │ -E8049A3DD9EDA09CCEE4998998661CF7DB35E952F6C65DAEB3013951C59F3E09 │ │ │ │ │ -157F313B0237876E1C0190F0473819570B8C0205AADF05D787CC00979CFB327A │ │ │ │ │ -289382B22DDA6F12804ED0ED5B179E36A995A2A59E1B66E75130DBE9109C813B │ │ │ │ │ -94403E0DEA8314A1E9DB474D7FA83C0BAFD08033E6A6215844C1D26BE15F1251 │ │ │ │ │ -A1605E8DF9A9C601ED37379530BC1C82BE5463C6C711C5652BFD6262485AA9CA │ │ │ │ │ -B8C4A117593001D08D980041E2A83C190DCE8E6CD3D334E5CC19FC05DB30F7F7 │ │ │ │ │ -24A305C4DBB31F0651392B99D44B4302333BDF7E326FD256DD75D309C6E73F85 │ │ │ │ │ -FA71B35FD1F9BEFF4C7A1076362EEB0A85492933B6006086A7B8C1928CF2D1EE │ │ │ │ │ -FD4344409257BB802C117E739960821CD3C88BFBA5669FF16F610AD638AF3677 │ │ │ │ │ -8674C985E6767253ED5769F71BEA5E9BB02A751F9E62EE2B18AC19D975FDEAE9 │ │ │ │ │ -8B8822367FF177A7E850766DE99ED3366D46464612926430012212A90F8E85F4 │ │ │ │ │ -4760B40D5B86B90819EE410382C23E86DCAF4F0FF5DFEB2C285965F4DCF2FB2B │ │ │ │ │ -457C0A0427A8D4ADA514E9DACD0F9367E1DA225DB21DA4DDAE33F2B529686D92 │ │ │ │ │ -AC085B345565F9DFFA012FD494DBB2E0B44A0787B2B72DC8D25399DAAE8864B7 │ │ │ │ │ -E84AA99DAFCEAF18F8B41882720316450F1B1CA48B418C9736E5CE4AFF996111 │ │ │ │ │ -5F7FE80958B6A3498508E9693CB134402D92E30D4C2939070D4647E13682290E │ │ │ │ │ -1D0820A3FCA7147157D09D1A40771F214EAE7DD743EA26839E535CA186C05CB8 │ │ │ │ │ -4874988AA1104D85AF0220FE7224344FF624E794BD2454E1C0AC971522FBECBA │ │ │ │ │ -B2497F25CD621B77EC5160973EF5ECC39C183DC051B0DFCB090194A2525BD96E │ │ │ │ │ -28593FDA80D8D259F039416D5F9AF0AD3C9A105B49DAF6E681921E369B7666C6 │ │ │ │ │ -2B73DB37447B00AE96317C2F1C44FB6E6EFD740BAB20FA03A8CE018EC8415582 │ │ │ │ │ -FB06E88A2971E3A480FB1EB4FE93CC7E5179721CAABEE88742B13CF0405F49F4 │ │ │ │ │ -945E587668C821D8C06D6847B6DF84CAFFCD4628670D551FC5F7236875BE1207 │ │ │ │ │ -634BA7F70A19B658FAE7D86F6D00ED28FBF29CC585DEE279325EEF8B0CCB6149 │ │ │ │ │ -E46E638C73D75148F18A636DBC2DD96ED34F68A5A09A3700B1EA34B2D142807C │ │ │ │ │ -F8709D81180783548EAE6F457BF968602076A1069163E3C15BBCEF659C6CF2E6 │ │ │ │ │ -0BB01BDC8E503802CC7969A5B8477E9788C5249B23B19669F5075E089738E49A │ │ │ │ │ -8671D7C1B1B47652F3D78BF2FF74EDB44BA5B092E8D5B85001E97F69D54AEEFC │ │ │ │ │ -88FC3CA1B0D5BAC39263B371005BCFA19AD197A31CC34D0BD55C2CA18C60C485 │ │ │ │ │ -5993F736EF1DD2C5D2B4D50B3D498861B4DF5E7AFF614BBCA4C2E6BECC0DCEF5 │ │ │ │ │ -95F0D686188014C530D8E37650CDCAE721B4AFB0F178BC744BDDDED45DAB7FEB │ │ │ │ │ -A10B975E26099E3DC61116D6BF554574F948895B88EEFE03DCC5351190836AD4 │ │ │ │ │ -EBC1AC55C6D099A8E7B0A372D290C481F44FA464B9C11A0BC991CB045E0AAAC4 │ │ │ │ │ -5C73CA43A4F17D1ADDD33D1B917FF95BFF411C8409F41553B1BC97DE47E3A1F4 │ │ │ │ │ -A5C1D1B7B1BF7E2507AC53956C141411F4F657E37981996DD7BB7ADB2CB6AE01 │ │ │ │ │ -73D0876B8F896F626D5022FE53BA34D5668BD698BE8D5CCAD083CBCEF440BE6A │ │ │ │ │ -8090EB1CDEE5F99C8988650BD4E539B357C31C597D8A9104A9D5967D4E906CAD │ │ │ │ │ -2A65575A884B1C5F6CC509E742FA9DDD66494F219178161AF72C50848E226A95 │ │ │ │ │ -A8C247FF9FF0BABD073021271B5C0692F9BE220071DAB09E5A026629371EE3C4 │ │ │ │ │ -A6E4FA94625D87A5B66EF077ED54C72B1052AEAA9637B30C76EF8EB04AD5F476 │ │ │ │ │ -D15F1C93C0BC6E0F67B366097BBED03FE82C040F9EF02866159B46854E11D44F │ │ │ │ │ -54AE6748A7E61B993A4EECD3B8BE3B5897A66BBCDFE24F65BC2AD5AB49048CF1 │ │ │ │ │ -647203823F84DF5CB483096F9D96AEE3A2855E479B72A14A67C633CE99C101CF │ │ │ │ │ -EFAE939BF9B02E710D │ │ │ │ │ +1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004ACD1870 │ │ │ │ │ +A5EA947858F5795870BFE1343AD803FB854BF8F5A4E794E8EC57BE41DB5B8734 │ │ │ │ │ +13E47950F29A81EA0C81EA798863883D7F41F78325CA190CBBFFE822AE494550 │ │ │ │ │ +4BE83703071FC9512D128927AF3F63CEF8F86ABE1E15D7B4DDD39576E7DFF45E │ │ │ │ │ +3CB4115AAB1830DE8647B915DB4BEBEB5235C281E098B899BAB951D8D5798F01 │ │ │ │ │ +7F7C47336D31438E5126738AFEAB29E9A7CBE06DE4DD604477B542D2620DFD58 │ │ │ │ │ +28FE34238572F23C5A8EB7ACEE1E154DA13FC1A5AA67A3BA8C5CDFB2B80312C9 │ │ │ │ │ +BC9FAE56D08DDFA9498E6EF0D0F6BD18B3923E0B670B0740528BC843610736CB │ │ │ │ │ +80228C105C2F72C3C22D610C3D8C268DEEA2AEEE3221E198E79FE2966487360C │ │ │ │ │ +84AE08AC326F48B21447652121B1EB68AF856055EEA65B6B625BF622CBFC2D1C │ │ │ │ │ +EF943CC4CAF2C715782C9EF9A9BA4689BFC6B6A82F8D55795BE8111E2C7DE520 │ │ │ │ │ +367362304B6A48186C842033E715A46265A352472F4F7313248EBCD26BEA97E7 │ │ │ │ │ +B814A61D4B7ADCB5C5F21AA34E0C1269E8426DBFB511DE6E26B960456C8F8520 │ │ │ │ │ +5F0DD382289A62AF0B935EDB5B2394538C5F0EE72962D2F98F3C38CD7C027B9F │ │ │ │ │ +E230E67E40FEFBDED06B3423C9DFD669E6B5BC913E0FF75786A64A6C11D4FE89 │ │ │ │ │ +1B918DC0E953C52CFD153063CD0D2A78B43F8712243845E6F2CBA1DB610F403D │ │ │ │ │ +A98D06D95FF44C7AC029092B666A8B0DCEA95B34F5ACC10E8611BADE6A24469C │ │ │ │ │ +0C01D95BFB445FA22CD38D033E4D24E006BB9D54EE41EF7AD5AC9C299721F61A │ │ │ │ │ +F01B6EDCDF428BD9195A13C5B1027358F8A203F828A1DD9622243B2D76C6F1BA │ │ │ │ │ +9F2D7E9D4879FC668ABC750CD25415DC6CCF2257C28F78D3F9BE499CC0FF2F80 │ │ │ │ │ +2C2CD1DEFABD6668FCA76E1D629A344333E33DA24B86D2E9F8F5EE1C29974640 │ │ │ │ │ +C3E78E999BAB313400041DADDDFDBFFCC419F129A84F4D412B79E8BE4511CA00 │ │ │ │ │ +F92A4F3CDD2E51345D3965C104F06B6503445DC20224CB7606A9D7D5F9EE45E6 │ │ │ │ │ +1B2963DA96AA2AB1BA5BE29656E666E4D0E122DE58EEA68E04ED76438DA03E65 │ │ │ │ │ +B80055A86B7B2A26BAE6BBB8835E17F9696E9B3CD34571BA75C76D4D2CCC48F1 │ │ │ │ │ +7534C1EF9127E374D65D05B8072E08D6C72A0B4A35EA0DD717743C66D105CCD8 │ │ │ │ │ +7355F13E9C38C1A4351624E689ED7909100942FA0474842EE44DEC3279E1A1CD │ │ │ │ │ +8064666EB845CA7C3E906B67C0BF96A28D514DB2E4A1E4AF287350B03762A2CF │ │ │ │ │ +13B18AC3F5D2F3B74A1D50267C03EFB74B888E1D24ABEEA4A885F4D0BF14C0D8 │ │ │ │ │ +289AC79D6D98E2A2C831672FB1F3457564CD161ADC3AF610D88201AB5B0C10CB │ │ │ │ │ +5ECCC2D5C4AF39C8CB3044BF9EC791BA45D29C2B51EA0483D19822C264CE6FA3 │ │ │ │ │ +5C97F2DF5A78CB93528E99B9ED7CB121C83130C129B849B52A36EBD88AF19DD3 │ │ │ │ │ +C5CABE831027388EF86BD5CBD90AAAC089775938A321C44D4DDA67A51312D8AB │ │ │ │ │ +C509DDBE7044A107AB2BE9C4C9556F85C529B174A7778B489BF28EC07A834542 │ │ │ │ │ +8B31F2925C21FB2096877711F998763D5A8495002B8E080AF8DBB1B3106EDDBA │ │ │ │ │ +35121D52E0846A7AF3ABEDF87BDE4FA665673A9B80CA538B98F873947AA17EF4 │ │ │ │ │ +9BB182917E9D79BC7EC681E93710D6A1D6B0E4A7FA9452FC1C431808174F3AB7 │ │ │ │ │ +F3914FBC86CB34E8583457243C3C7BE4BC166C7397689BC6FFB82EA2967E88EE │ │ │ │ │ +464F96EDA144DE2B64401B8E577ABCA2D826FE0B92E21FFAE3E81EBB6B6EB36E │ │ │ │ │ +9B1A8FE3884CA398C03135FD49D51724FC1268E9482E41FAEA2FC6C809006B8F │ │ │ │ │ +5D4F9E038450AD3A6041C16FD1C7E5FC80C0E033CE57E64863E014531D94DF1E │ │ │ │ │ +31D7D038AFCB60715AA73C1E96F113A24C5AF35BBEB61C4D079ED034ED83AA4A │ │ │ │ │ +E12448E618330463304788BCF40561CD63167B3BF144F408E2B89E60B8BA13EF │ │ │ │ │ +3B57D286FD23D4FA8BAEFF98DC1188B1982956CC1DCAEFC7D949B7B4E3BE8F8A │ │ │ │ │ +BFE2C9D938DD13EFEE7123576608D9396F260907DA98AE2D3DD5822306CBC8A6 │ │ │ │ │ +B083C697DDA3C62EE7879436A9FD8EE0034B105105B3F122F893EA2126EBE8A9 │ │ │ │ │ +5CBF2BD248DD9FBEF0040C25797BD13B69A8C9F0D4E4F935C61ED30487CCDB1A │ │ │ │ │ +0339006E78EE1755929D2412776EC7DB1F666DBDD28EA8AC7397F809C7F38A41 │ │ │ │ │ +5B3BF6C75F4F35C90141EB08377AF452CF840FEA938805F9D14E02DC29215B4E │ │ │ │ │ +F1EB │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ @@ -3640,16 +3631,16 @@ │ │ │ │ │ {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 23[45 19[83 18[25 2[45 │ │ │ │ │ -2[45 1[45 45 45 3[25 44[{}10 90.9091 /CMSL10 rf │ │ │ │ │ +119.552 /CMTT12 rf /Fd 138[51 6[51 8[40 26[47 15[25 4[45 │ │ │ │ │ +2[45 1[45 3[25 44[{}9 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 │ │ │ │ │ @@ -3766,17 +3757,17 @@ │ │ │ │ │ 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 1203 4 v │ │ │ │ │ -1385 w Fi(Tree)29 b Fd(:)41 b Fh(DRAFT)30 b Fd(Ma)m(y)h(17,)h(2024)p │ │ │ │ │ -2698 100 V 0 399 a Ff(1.2)135 b(Protot)l(yp)t(es)46 b(and)f │ │ │ │ │ +TeXDict begin 2 1 bop 0 100 a Fj(2)p 136 100 1196 4 v │ │ │ │ │ +1378 w Fi(Tree)29 b Fd(:)41 b Fh(DRAFT)30 b Fd(June)f(20,)j(2025)p │ │ │ │ │ +2704 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 │ │ │ │ │ @@ -3830,17 +3821,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 1203 4 v 1384 100 a Fi(Tree)29 │ │ │ │ │ -b Fd(:)41 b Fh(DRAFT)121 b Fd(Ma)m(y)32 b(17,)f(2024)p │ │ │ │ │ -2650 100 V 1203 w Fj(3)0 399 y Fb(1.2.3)112 b(Initializer)38 │ │ │ │ │ +TeXDict begin 3 2 bop 91 100 1196 4 v 1377 100 a Fi(Tree)30 │ │ │ │ │ +b Fd(:)40 b Fh(DRAFT)121 b Fd(June)30 b(20,)h(2025)p │ │ │ │ │ +2657 100 V 1196 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 │ │ │ │ │ @@ -3908,17 +3899,17 @@ │ │ │ │ │ (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 1203 4 v │ │ │ │ │ -1385 w Fi(Tree)29 b Fd(:)41 b Fh(DRAFT)30 b Fd(Ma)m(y)h(17,)h(2024)p │ │ │ │ │ -2698 100 V 111 399 a Fj(3.)46 b Fi(IV)h(*)h(DSTree_MS2stages)43 │ │ │ │ │ +TeXDict begin 4 3 bop 0 100 a Fj(4)p 136 100 1196 4 v │ │ │ │ │ +1378 w Fi(Tree)29 b Fd(:)41 b Fh(DRAFT)30 b Fd(June)f(20,)j(2025)p │ │ │ │ │ +2704 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 │ │ │ │ │ @@ -3989,17 +3980,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 1203 4 v 1384 100 a Fi(Tree)29 │ │ │ │ │ -b Fd(:)41 b Fh(DRAFT)121 b Fd(Ma)m(y)32 b(17,)f(2024)p │ │ │ │ │ -2650 100 V 1203 w Fj(5)111 399 y(3.)46 b Fi(int)h(DSTree_domainWeight)c │ │ │ │ │ +TeXDict begin 5 4 bop 91 100 1196 4 v 1377 100 a Fi(Tree)30 │ │ │ │ │ +b Fd(:)40 b Fh(DRAFT)121 b Fd(June)30 b(20,)h(2025)p │ │ │ │ │ +2657 100 V 1196 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 │ │ │ │ │ @@ -4066,17 +4057,17 @@ │ │ │ │ │ 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 1203 4 v │ │ │ │ │ -1385 w Fi(Tree)29 b Fd(:)41 b Fh(DRAFT)30 b Fd(Ma)m(y)h(17,)h(2024)p │ │ │ │ │ -2698 100 V 111 399 a Fj(5.)46 b Fi(int)h(DSTree_writeToFormattedFi)o │ │ │ │ │ +TeXDict begin 6 5 bop 0 100 a Fj(6)p 136 100 1196 4 v │ │ │ │ │ +1378 w Fi(Tree)29 b Fd(:)41 b Fh(DRAFT)30 b Fd(June)f(20,)j(2025)p │ │ │ │ │ +2704 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 │ │ │ │ │ @@ -4150,17 +4141,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 1203 4 v 1384 100 a Fi(Tree)29 │ │ │ │ │ -b Fd(:)41 b Fh(DRAFT)121 b Fd(Ma)m(y)32 b(17,)f(2024)p │ │ │ │ │ -2650 100 V 1203 w Fj(7)111 399 y(2.)46 b Fi(writeStagesIV)e(msglvl)j │ │ │ │ │ +TeXDict begin 7 6 bop 91 100 1196 4 v 1377 100 a Fi(Tree)30 │ │ │ │ │ +b Fd(:)40 b Fh(DRAFT)121 b Fd(June)30 b(20,)h(2025)p │ │ │ │ │ +2657 100 V 1196 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 May 17, 2024 │ │ │ │ │ │ + 2 Tree : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 3 │ │ │ │ │ │ + Tree : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 4 Tree : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 5 │ │ │ │ │ │ + Tree : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 6 Tree : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 7 │ │ │ │ │ │ + Tree : DRAFT June 20, 2025 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 2024.05.17:2217 │ │ │ │ │ +%DVIPSSource: TeX output 2025.06.20:0449 │ │ │ │ │ %%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 │ │ │ │ │ @@ -2350,22 +2350,21 @@ │ │ │ │ │ /UnderlinePosition -100 def │ │ │ │ │ /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 49 /one put │ │ │ │ │ dup 50 /two put │ │ │ │ │ -dup 52 /four put │ │ │ │ │ -dup 55 /seven put │ │ │ │ │ +dup 53 /five put │ │ │ │ │ dup 58 /colon put │ │ │ │ │ -dup 77 /M put │ │ │ │ │ -dup 97 /a put │ │ │ │ │ -dup 121 /y put │ │ │ │ │ +dup 74 /J put │ │ │ │ │ +dup 101 /e put │ │ │ │ │ +dup 110 /n put │ │ │ │ │ +dup 117 /u put │ │ │ │ │ readonly def │ │ │ │ │ currentdict end │ │ │ │ │ currentfile eexec │ │ │ │ │ D9D66F633B846AB284BCF8B0411B772DE5CE32340DC6F28AF40857E4451976E7 │ │ │ │ │ 5182433CF9F333A38BD841C0D4E68BF9E012EB32A8FFB76B5816306B5EDF7C99 │ │ │ │ │ 8B3A16D9B4BC056662E32C7CD0123DFAEB734C7532E64BBFBF5A60336E646716 │ │ │ │ │ EFB852C877F440D329172C71F1E5D59CE9473C26B8AEF7AD68EF0727B6EC2E0C │ │ │ │ │ @@ -2546,72 +2545,64 @@ │ │ │ │ │ 7CA1534C4D5B05FC33F83790ECFD7641DF3FB94289E2A1F6E7D29AB1228A867A │ │ │ │ │ 6E1EF0E9C6F899B491DC18401C2C0A05FFFED46A72C245F7529B8EA55A038082 │ │ │ │ │ 8512307217D2A233C37004085BA3AEE379269F9FA7D0ADB4B19A95CC2AFE686E │ │ │ │ │ 55D88E47257C1FE6F235FEA295910569FE6DD5995512562359CC821E85A6C7A5 │ │ │ │ │ 79B470A9E340A6985189FF8B6AF914A6B0ECF93F47903221F95DE894A8F05B05 │ │ │ │ │ B7D99CD533EC5F931B18E6B39BECF67FA2D6DD1AEC76772B068BE06335A94C05 │ │ │ │ │ 7A4DDEE77B66101DA855C17AC312600370B34E31F5EC3A01300A8EB60B4C9767 │ │ │ │ │ -1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004B9BA1CC │ │ │ │ │ -580D3C6BDA4DC1B80B4365F1C80512453FC5316EC2D928FB731C3D6403E3C18B │ │ │ │ │ -E8424D644DF5E9A2134229C5C91CA68DB8E85BA2BB40F538F585DA6FA4037718 │ │ │ │ │ -B8053EBBA1E765346BCD5BDAA6C38115D31611D8A87A2238C145F2DA2F92E4DF │ │ │ │ │ -3987BD9C4D2A3D460E8941A68B125BCD9EE4F9FD262C4C8A71F47A2C81975635 │ │ │ │ │ -F1B981C274C53FA2ACCDE4C9D0A7C62D6C1EFF91CFC6712CA6A9F333C9564FCB │ │ │ │ │ -2A70F0AD715A79B10A08AB069E2A3C93BC0AED19D0CA10134B8DDDE8AF548DB2 │ │ │ │ │ -3A4AAA9C29682CF135BB767DAA16169A127EB50A7EECEB6480CF56A7D0F8AC56 │ │ │ │ │ -4A5090B3D75A790372886AF568D94C8165975A05BFBFDF1FFBA45F70700BB9E0 │ │ │ │ │ -57F3249EF9E9C8AD9CBCF6E4FD592DC4CDD2CC7C0BC3130C1059096C657BE453 │ │ │ │ │ -A2CBACE93420210E27AF56CA229BD6D982FB68B3FDC6D44478B922C4231C47EE │ │ │ │ │ -E500232F6C11D92DEB955F66DF52B92B22E7352790CC2DCBAC53965D57AC2920 │ │ │ │ │ -68B7D520DE25047146EFEB06B9AD4E2A94243C7E5239F0BC2FC312B16051D52C │ │ │ │ │ -0B92C217B6B42997321AE4F8BB066754B7AA3F15069EF59224E8A442CE471AA7 │ │ │ │ │ -E8049A3DD9EDA09CCEE4998998661CF7DB35E952F6C65DAEB3013951C59F3E09 │ │ │ │ │ -157F313B0237876E1C0190F0473819570B8C0205AADF05D787CC00979CFB327A │ │ │ │ │ -289382B22DDA6F12804ED0ED5B179E36A995A2A59E1B66E75130DBE9109C813B │ │ │ │ │ -94403E0DEA8314A1E9DB474D7FA83C0BAFD08033E6A6215844C1D26BE15F1251 │ │ │ │ │ -A1605E8DF9A9C601ED37379530BC1C82BE5463C6C711C5652BFD6262485AA9CA │ │ │ │ │ -B8C4A117593001D08D980041E2A83C190DCE8E6CD3D334E5CC19FC05DB30F7F7 │ │ │ │ │ -24A305C4DBB31F0651392B99D44B4302333BDF7E326FD256DD75D309C6E73F85 │ │ │ │ │ -FA71B35FD1F9BEFF4C7A1076362EEB0A85492933B6006086A7B8C1928CF2D1EE │ │ │ │ │ -FD4344409257BB802C117E739960821CD3C88BFBA5669FF16F610AD638AF3677 │ │ │ │ │ -8674C985E6767253ED5769F71BEA5E9BB02A751F9E62EE2B18AC19D975FDEAE9 │ │ │ │ │ -8B8822367FF177A7E850766DE99ED3366D46464612926430012212A90F8E85F4 │ │ │ │ │ -4760B40D5B86B90819EE410382C23E86DCAF4F0FF5DFEB2C285965F4DCF2FB2B │ │ │ │ │ -457C0A0427A8D4ADA514E9DACD0F9367E1DA225DB21DA4DDAE33F2B529686D92 │ │ │ │ │ -AC085B345565F9DFFA012FD494DBB2E0B44A0787B2B72DC8D25399DAAE8864B7 │ │ │ │ │ -E84AA99DAFCEAF18F8B41882720316450F1B1CA48B418C9736E5CE4AFF996111 │ │ │ │ │ -5F7FE80958B6A3498508E9693CB134402D92E30D4C2939070D4647E13682290E │ │ │ │ │ -1D0820A3FCA7147157D09D1A40771F214EAE7DD743EA26839E535CA186C05CB8 │ │ │ │ │ -4874988AA1104D85AF0220FE7224344FF624E794BD2454E1C0AC971522FBECBA │ │ │ │ │ -B2497F25CD621B77EC5160973EF5ECC39C183DC051B0DFCB090194A2525BD96E │ │ │ │ │ -28593FDA80D8D259F039416D5F9AF0AD3C9A105B49DAF6E681921E369B7666C6 │ │ │ │ │ -2B73DB37447B00AE96317C2F1C44FB6E6EFD740BAB20FA03A8CE018EC8415582 │ │ │ │ │ -FB06E88A2971E3A480FB1EB4FE93CC7E5179721CAABEE88742B13CF0405F49F4 │ │ │ │ │ -945E587668C821D8C06D6847B6DF84CAFFCD4628670D551FC5F7236875BE1207 │ │ │ │ │ -634BA7F70A19B658FAE7D86F6D00ED28FBF29CC585DEE279325EEF8B0CCB6149 │ │ │ │ │ -E46E638C73D75148F18A636DBC2DD96ED34F68A5A09A3700B1EA34B2D142807C │ │ │ │ │ -F8709D81180783548EAE6F457BF968602076A1069163E3C15BBCEF659C6CF2E6 │ │ │ │ │ -0BB01BDC8E503802CC7969A5B8477E9788C5249B23B19669F5075E089738E49A │ │ │ │ │ -8671D7C1B1B47652F3D78BF2FF74EDB44BA5B092E8D5B85001E97F69D54AEEFC │ │ │ │ │ -88FC3CA1B0D5BAC39263B371005BCFA19AD197A31CC34D0BD55C2CA18C60C485 │ │ │ │ │ -5993F736EF1DD2C5D2B4D50B3D498861B4DF5E7AFF614BBCA4C2E6BECC0DCEF5 │ │ │ │ │ -95F0D686188014C530D8E37650CDCAE721B4AFB0F178BC744BDDDED45DAB7FEB │ │ │ │ │ -A10B975E26099E3DC61116D6BF554574F948895B88EEFE03DCC5351190836AD4 │ │ │ │ │ -EBC1AC55C6D099A8E7B0A372D290C481F44FA464B9C11A0BC991CB045E0AAAC4 │ │ │ │ │ -5C73CA43A4F17D1ADDD33D1B917FF95BFF411C8409F41553B1BC97DE47E3A1F4 │ │ │ │ │ -A5C1D1B7B1BF7E2507AC53956C141411F4F657E37981996DD7BB7ADB2CB6AE01 │ │ │ │ │ -73D0876B8F896F626D5022FE53BA34D5668BD698BE8D5CCAD083CBCEF440BE6A │ │ │ │ │ -8090EB1CDEE5F99C8988650BD4E539B357C31C597D8A9104A9D5967D4E906CAD │ │ │ │ │ -2A65575A884B1C5F6CC509E742FA9DDD66494F219178161AF72C50848E226A95 │ │ │ │ │ -A8C247FF9FF0BABD073021271B5C0692F9BE220071DAB09E5A026629371EE3C4 │ │ │ │ │ -A6E4FA94625D87A5B66EF077ED54C72B1052AEAA9637B30C76EF8EB04AD5F476 │ │ │ │ │ -D15F1C93C0BC6E0F67B366097BBED03FE82C040F9EF02866159B46854E11D44F │ │ │ │ │ -54AE6748A7E61B993A4EECD3B8BE3B5897A66BBCDFE24F65BC2AD5AB49048CF1 │ │ │ │ │ -647203823F84DF5CB483096F9D96AEE3A2855E479B72A14A67C633CE99C101CF │ │ │ │ │ -EFAE939BF9B02E710D │ │ │ │ │ +1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004ACD1870 │ │ │ │ │ +A5EA947858F5795870BFE1343AD803FB854BF8F5A4E794E8EC57BE41DB5B8734 │ │ │ │ │ +13E47950F29A81EA0C81EA798863883D7F41F78325CA190CBBFFE822AE494550 │ │ │ │ │ +4BE83703071FC9512D128927AF3F63CEF8F86ABE1E15D7B4DDD39576E7DFF45E │ │ │ │ │ +3CB4115AAB1830DE8647B915DB4BEBEB5235C281E098B899BAB951D8D5798F01 │ │ │ │ │ +7F7C47336D31438E5126738AFEAB29E9A7CBE06DE4DD604477B542D2620DFD58 │ │ │ │ │ +28FE34238572F23C5A8EB7ACEE1E154DA13FC1A5AA67A3BA8C5CDFB2B80312C9 │ │ │ │ │ +BC9FAE56D08DDFA9498E6EF0D0F6BD18B3923E0B670B0740528BC843610736CB │ │ │ │ │ +80228C105C2F72C3C22D610C3D8C268DEEA2AEEE3221E198E79FE2966487360C │ │ │ │ │ +84AE08AC326F48B21447652121B1EB68AF856055EEA65B6B625BF622CBFC2D1C │ │ │ │ │ +EF943CC4CAF2C715782C9EF9A9BA4689BFC6B6A82F8D55795BE8111E2C7DE520 │ │ │ │ │ +367362304B6A48186C842033E715A46265A352472F4F7313248EBCD26BEA97E7 │ │ │ │ │ +B814A61D4B7ADCB5C5F21AA34E0C1269E8426DBFB511DE6E26B960456C8F8520 │ │ │ │ │ +5F0DD382289A62AF0B935EDB5B2394538C5F0EE72962D2F98F3C38CD7C027B9F │ │ │ │ │ +E230E67E40FEFBDED06B3423C9DFD669E6B5BC913E0FF75786A64A6C11D4FE89 │ │ │ │ │ +1B918DC0E953C52CFD153063CD0D2A78B43F8712243845E6F2CBA1DB610F403D │ │ │ │ │ +A98D06D95FF44C7AC029092B666A8B0DCEA95B34F5ACC10E8611BADE6A24469C │ │ │ │ │ +0C01D95BFB445FA22CD38D033E4D24E006BB9D54EE41EF7AD5AC9C299721F61A │ │ │ │ │ +F01B6EDCDF428BD9195A13C5B1027358F8A203F828A1DD9622243B2D76C6F1BA │ │ │ │ │ +9F2D7E9D4879FC668ABC750CD25415DC6CCF2257C28F78D3F9BE499CC0FF2F80 │ │ │ │ │ +2C2CD1DEFABD6668FCA76E1D629A344333E33DA24B86D2E9F8F5EE1C29974640 │ │ │ │ │ +C3E78E999BAB313400041DADDDFDBFFCC419F129A84F4D412B79E8BE4511CA00 │ │ │ │ │ +F92A4F3CDD2E51345D3965C104F06B6503445DC20224CB7606A9D7D5F9EE45E6 │ │ │ │ │ +1B2963DA96AA2AB1BA5BE29656E666E4D0E122DE58EEA68E04ED76438DA03E65 │ │ │ │ │ +B80055A86B7B2A26BAE6BBB8835E17F9696E9B3CD34571BA75C76D4D2CCC48F1 │ │ │ │ │ +7534C1EF9127E374D65D05B8072E08D6C72A0B4A35EA0DD717743C66D105CCD8 │ │ │ │ │ +7355F13E9C38C1A4351624E689ED7909100942FA0474842EE44DEC3279E1A1CD │ │ │ │ │ +8064666EB845CA7C3E906B67C0BF96A28D514DB2E4A1E4AF287350B03762A2CF │ │ │ │ │ +13B18AC3F5D2F3B74A1D50267C03EFB74B888E1D24ABEEA4A885F4D0BF14C0D8 │ │ │ │ │ +289AC79D6D98E2A2C831672FB1F3457564CD161ADC3AF610D88201AB5B0C10CB │ │ │ │ │ +5ECCC2D5C4AF39C8CB3044BF9EC791BA45D29C2B51EA0483D19822C264CE6FA3 │ │ │ │ │ +5C97F2DF5A78CB93528E99B9ED7CB121C83130C129B849B52A36EBD88AF19DD3 │ │ │ │ │ +C5CABE831027388EF86BD5CBD90AAAC089775938A321C44D4DDA67A51312D8AB │ │ │ │ │ +C509DDBE7044A107AB2BE9C4C9556F85C529B174A7778B489BF28EC07A834542 │ │ │ │ │ +8B31F2925C21FB2096877711F998763D5A8495002B8E080AF8DBB1B3106EDDBA │ │ │ │ │ +35121D52E0846A7AF3ABEDF87BDE4FA665673A9B80CA538B98F873947AA17EF4 │ │ │ │ │ +9BB182917E9D79BC7EC681E93710D6A1D6B0E4A7FA9452FC1C431808174F3AB7 │ │ │ │ │ +F3914FBC86CB34E8583457243C3C7BE4BC166C7397689BC6FFB82EA2967E88EE │ │ │ │ │ +464F96EDA144DE2B64401B8E577ABCA2D826FE0B92E21FFAE3E81EBB6B6EB36E │ │ │ │ │ +9B1A8FE3884CA398C03135FD49D51724FC1268E9482E41FAEA2FC6C809006B8F │ │ │ │ │ +5D4F9E038450AD3A6041C16FD1C7E5FC80C0E033CE57E64863E014531D94DF1E │ │ │ │ │ +31D7D038AFCB60715AA73C1E96F113A24C5AF35BBEB61C4D079ED034ED83AA4A │ │ │ │ │ +E12448E618330463304788BCF40561CD63167B3BF144F408E2B89E60B8BA13EF │ │ │ │ │ +3B57D286FD23D4FA8BAEFF98DC1188B1982956CC1DCAEFC7D949B7B4E3BE8F8A │ │ │ │ │ +BFE2C9D938DD13EFEE7123576608D9396F260907DA98AE2D3DD5822306CBC8A6 │ │ │ │ │ +B083C697DDA3C62EE7879436A9FD8EE0034B105105B3F122F893EA2126EBE8A9 │ │ │ │ │ +5CBF2BD248DD9FBEF0040C25797BD13B69A8C9F0D4E4F935C61ED30487CCDB1A │ │ │ │ │ +0339006E78EE1755929D2412776EC7DB1F666DBDD28EA8AC7397F809C7F38A41 │ │ │ │ │ +5B3BF6C75F4F35C90141EB08377AF452CF840FEA938805F9D14E02DC29215B4E │ │ │ │ │ +F1EB │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ @@ -4185,19 +4176,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 23[45 19[83 18[25 2[45 │ │ │ │ │ -2[45 1[45 45 45 3[25 44[{}10 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 138[51 6[51 8[40 26[47 15[25 4[45 │ │ │ │ │ +2[45 1[45 3[25 44[{}9 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 │ │ │ │ │ @@ -4312,17 +4303,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 1256 4 v │ │ │ │ │ -1438 w Fk(DV)29 b Fg(:)i Ff(DRAFT)f Fg(Ma)m(y)i(17,)f(2024)p │ │ │ │ │ -2645 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 1249 4 v │ │ │ │ │ +1431 w Fk(DV)29 b Fg(:)i Ff(DRAFT)f Fg(June)g(20,)h(2025)p │ │ │ │ │ +2652 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 │ │ │ │ │ @@ -4376,17 +4367,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 1256 4 v 1437 100 a Fk(DV)30 │ │ │ │ │ -b Fg(:)g Ff(DRAFT)121 b Fg(Ma)m(y)32 b(17,)f(2024)p 2597 │ │ │ │ │ -100 V 1256 w Fl(3)0 399 y Fd(1.2.2)112 b(Instance)38 │ │ │ │ │ +TeXDict begin 3 2 bop 91 100 1249 4 v 1430 100 a Fk(DV)30 │ │ │ │ │ +b Fg(:)g Ff(DRAFT)122 b Fg(June)29 b(20,)i(2025)p 2604 │ │ │ │ │ +100 V 1249 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 │ │ │ │ │ @@ -4440,17 +4431,17 @@ │ │ │ │ │ (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 1256 4 v │ │ │ │ │ -1438 w Fk(DV)29 b Fg(:)i Ff(DRAFT)f Fg(Ma)m(y)i(17,)f(2024)p │ │ │ │ │ -2645 100 V 0 399 a Fd(1.2.3)112 b(Initializer)38 b(metho)s(ds)0 │ │ │ │ │ +TeXDict begin 4 3 bop 0 100 a Fl(4)p 136 100 1249 4 v │ │ │ │ │ +1431 w Fk(DV)29 b Fg(:)i Ff(DRAFT)f Fg(June)g(20,)h(2025)p │ │ │ │ │ +2652 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 │ │ │ │ │ @@ -4526,17 +4517,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 1256 4 v 1437 100 a Fk(DV)30 │ │ │ │ │ -b Fg(:)g Ff(DRAFT)121 b Fg(Ma)m(y)32 b(17,)f(2024)p 2597 │ │ │ │ │ -100 V 1256 w Fl(5)227 399 y(the)37 b(v)m(ector)h(is)e(lost,)j(namely)e │ │ │ │ │ +TeXDict begin 5 4 bop 91 100 1249 4 v 1430 100 a Fk(DV)30 │ │ │ │ │ +b Fg(:)g Ff(DRAFT)122 b Fg(June)29 b(20,)i(2025)p 2604 │ │ │ │ │ +100 V 1249 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 │ │ │ │ │ @@ -4595,17 +4586,17 @@ │ │ │ │ │ 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 1256 4 v │ │ │ │ │ -1438 w Fk(DV)29 b Fg(:)i Ff(DRAFT)f Fg(Ma)m(y)i(17,)f(2024)p │ │ │ │ │ -2645 100 V 111 399 a Fl(8.)46 b Fk(double)g(*)i(DV_first)d(\()j(DV)f │ │ │ │ │ +TeXDict begin 6 5 bop 0 100 a Fl(6)p 136 100 1249 4 v │ │ │ │ │ +1431 w Fk(DV)29 b Fg(:)i Ff(DRAFT)f Fg(June)g(20,)h(2025)p │ │ │ │ │ +2652 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 │ │ │ │ │ @@ -4665,17 +4656,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 1256 4 v 1437 100 a Fk(DV)30 │ │ │ │ │ -b Fg(:)g Ff(DRAFT)121 b Fg(Ma)m(y)32 b(17,)f(2024)p 2597 │ │ │ │ │ -100 V 1256 w Fl(7)111 399 y(1.)46 b Fk(int)h(DV_readFromFile)d(\()j(DV) │ │ │ │ │ +TeXDict begin 7 6 bop 91 100 1249 4 v 1430 100 a Fk(DV)30 │ │ │ │ │ +b Fg(:)g Ff(DRAFT)122 b Fg(June)29 b(20,)i(2025)p 2604 │ │ │ │ │ +100 V 1249 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 │ │ │ │ │ @@ -4756,17 +4747,17 @@ │ │ │ │ │ (\))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 1256 4 v │ │ │ │ │ -1438 w Fk(DV)29 b Fg(:)i Ff(DRAFT)f Fg(Ma)m(y)i(17,)f(2024)p │ │ │ │ │ -2645 100 V 111 399 a Fl(9.)46 b Fk(int)h(DV_writeForMatlab)c(\()48 │ │ │ │ │ +TeXDict begin 8 7 bop 0 100 a Fl(8)p 136 100 1249 4 v │ │ │ │ │ +1431 w Fk(DV)29 b Fg(:)i Ff(DRAFT)f Fg(June)g(20,)h(2025)p │ │ │ │ │ +2652 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 │ │ │ │ │ ├── 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 May 17, 2024 │ │ │ │ │ │ + 2 DV : DRAFT June 20, 2025 │ │ │ │ │ │ • 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 May 17, 2024 3 │ │ │ │ │ │ + DV : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 4 DV : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 5 │ │ │ │ │ │ + DV : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 6 DV : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 7 │ │ │ │ │ │ + DV : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 8 DV : DRAFT June 20, 2025 │ │ │ │ │ │ 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 2024.05.17:2217 │ │ │ │ │ +%DVIPSSource: TeX output 2025.06.20:0449 │ │ │ │ │ %%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 │ │ │ │ │ @@ -1621,22 +1621,21 @@ │ │ │ │ │ /UnderlinePosition -100 def │ │ │ │ │ /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 49 /one put │ │ │ │ │ dup 50 /two put │ │ │ │ │ -dup 52 /four put │ │ │ │ │ -dup 55 /seven put │ │ │ │ │ +dup 53 /five put │ │ │ │ │ dup 58 /colon put │ │ │ │ │ -dup 77 /M put │ │ │ │ │ -dup 97 /a put │ │ │ │ │ -dup 121 /y put │ │ │ │ │ +dup 74 /J put │ │ │ │ │ +dup 101 /e put │ │ │ │ │ +dup 110 /n put │ │ │ │ │ +dup 117 /u put │ │ │ │ │ readonly def │ │ │ │ │ currentdict end │ │ │ │ │ currentfile eexec │ │ │ │ │ D9D66F633B846AB284BCF8B0411B772DE5CE32340DC6F28AF40857E4451976E7 │ │ │ │ │ 5182433CF9F333A38BD841C0D4E68BF9E012EB32A8FFB76B5816306B5EDF7C99 │ │ │ │ │ 8B3A16D9B4BC056662E32C7CD0123DFAEB734C7532E64BBFBF5A60336E646716 │ │ │ │ │ EFB852C877F440D329172C71F1E5D59CE9473C26B8AEF7AD68EF0727B6EC2E0C │ │ │ │ │ @@ -1817,72 +1816,64 @@ │ │ │ │ │ 7CA1534C4D5B05FC33F83790ECFD7641DF3FB94289E2A1F6E7D29AB1228A867A │ │ │ │ │ 6E1EF0E9C6F899B491DC18401C2C0A05FFFED46A72C245F7529B8EA55A038082 │ │ │ │ │ 8512307217D2A233C37004085BA3AEE379269F9FA7D0ADB4B19A95CC2AFE686E │ │ │ │ │ 55D88E47257C1FE6F235FEA295910569FE6DD5995512562359CC821E85A6C7A5 │ │ │ │ │ 79B470A9E340A6985189FF8B6AF914A6B0ECF93F47903221F95DE894A8F05B05 │ │ │ │ │ B7D99CD533EC5F931B18E6B39BECF67FA2D6DD1AEC76772B068BE06335A94C05 │ │ │ │ │ 7A4DDEE77B66101DA855C17AC312600370B34E31F5EC3A01300A8EB60B4C9767 │ │ │ │ │ -1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004B9BA1CC │ │ │ │ │ -580D3C6BDA4DC1B80B4365F1C80512453FC5316EC2D928FB731C3D6403E3C18B │ │ │ │ │ -E8424D644DF5E9A2134229C5C91CA68DB8E85BA2BB40F538F585DA6FA4037718 │ │ │ │ │ -B8053EBBA1E765346BCD5BDAA6C38115D31611D8A87A2238C145F2DA2F92E4DF │ │ │ │ │ -3987BD9C4D2A3D460E8941A68B125BCD9EE4F9FD262C4C8A71F47A2C81975635 │ │ │ │ │ -F1B981C274C53FA2ACCDE4C9D0A7C62D6C1EFF91CFC6712CA6A9F333C9564FCB │ │ │ │ │ -2A70F0AD715A79B10A08AB069E2A3C93BC0AED19D0CA10134B8DDDE8AF548DB2 │ │ │ │ │ -3A4AAA9C29682CF135BB767DAA16169A127EB50A7EECEB6480CF56A7D0F8AC56 │ │ │ │ │ -4A5090B3D75A790372886AF568D94C8165975A05BFBFDF1FFBA45F70700BB9E0 │ │ │ │ │ -57F3249EF9E9C8AD9CBCF6E4FD592DC4CDD2CC7C0BC3130C1059096C657BE453 │ │ │ │ │ -A2CBACE93420210E27AF56CA229BD6D982FB68B3FDC6D44478B922C4231C47EE │ │ │ │ │ -E500232F6C11D92DEB955F66DF52B92B22E7352790CC2DCBAC53965D57AC2920 │ │ │ │ │ -68B7D520DE25047146EFEB06B9AD4E2A94243C7E5239F0BC2FC312B16051D52C │ │ │ │ │ -0B92C217B6B42997321AE4F8BB066754B7AA3F15069EF59224E8A442CE471AA7 │ │ │ │ │ -E8049A3DD9EDA09CCEE4998998661CF7DB35E952F6C65DAEB3013951C59F3E09 │ │ │ │ │ -157F313B0237876E1C0190F0473819570B8C0205AADF05D787CC00979CFB327A │ │ │ │ │ -289382B22DDA6F12804ED0ED5B179E36A995A2A59E1B66E75130DBE9109C813B │ │ │ │ │ -94403E0DEA8314A1E9DB474D7FA83C0BAFD08033E6A6215844C1D26BE15F1251 │ │ │ │ │ -A1605E8DF9A9C601ED37379530BC1C82BE5463C6C711C5652BFD6262485AA9CA │ │ │ │ │ -B8C4A117593001D08D980041E2A83C190DCE8E6CD3D334E5CC19FC05DB30F7F7 │ │ │ │ │ -24A305C4DBB31F0651392B99D44B4302333BDF7E326FD256DD75D309C6E73F85 │ │ │ │ │ -FA71B35FD1F9BEFF4C7A1076362EEB0A85492933B6006086A7B8C1928CF2D1EE │ │ │ │ │ -FD4344409257BB802C117E739960821CD3C88BFBA5669FF16F610AD638AF3677 │ │ │ │ │ -8674C985E6767253ED5769F71BEA5E9BB02A751F9E62EE2B18AC19D975FDEAE9 │ │ │ │ │ -8B8822367FF177A7E850766DE99ED3366D46464612926430012212A90F8E85F4 │ │ │ │ │ -4760B40D5B86B90819EE410382C23E86DCAF4F0FF5DFEB2C285965F4DCF2FB2B │ │ │ │ │ -457C0A0427A8D4ADA514E9DACD0F9367E1DA225DB21DA4DDAE33F2B529686D92 │ │ │ │ │ -AC085B345565F9DFFA012FD494DBB2E0B44A0787B2B72DC8D25399DAAE8864B7 │ │ │ │ │ -E84AA99DAFCEAF18F8B41882720316450F1B1CA48B418C9736E5CE4AFF996111 │ │ │ │ │ -5F7FE80958B6A3498508E9693CB134402D92E30D4C2939070D4647E13682290E │ │ │ │ │ -1D0820A3FCA7147157D09D1A40771F214EAE7DD743EA26839E535CA186C05CB8 │ │ │ │ │ -4874988AA1104D85AF0220FE7224344FF624E794BD2454E1C0AC971522FBECBA │ │ │ │ │ -B2497F25CD621B77EC5160973EF5ECC39C183DC051B0DFCB090194A2525BD96E │ │ │ │ │ -28593FDA80D8D259F039416D5F9AF0AD3C9A105B49DAF6E681921E369B7666C6 │ │ │ │ │ -2B73DB37447B00AE96317C2F1C44FB6E6EFD740BAB20FA03A8CE018EC8415582 │ │ │ │ │ -FB06E88A2971E3A480FB1EB4FE93CC7E5179721CAABEE88742B13CF0405F49F4 │ │ │ │ │ -945E587668C821D8C06D6847B6DF84CAFFCD4628670D551FC5F7236875BE1207 │ │ │ │ │ -634BA7F70A19B658FAE7D86F6D00ED28FBF29CC585DEE279325EEF8B0CCB6149 │ │ │ │ │ -E46E638C73D75148F18A636DBC2DD96ED34F68A5A09A3700B1EA34B2D142807C │ │ │ │ │ -F8709D81180783548EAE6F457BF968602076A1069163E3C15BBCEF659C6CF2E6 │ │ │ │ │ -0BB01BDC8E503802CC7969A5B8477E9788C5249B23B19669F5075E089738E49A │ │ │ │ │ -8671D7C1B1B47652F3D78BF2FF74EDB44BA5B092E8D5B85001E97F69D54AEEFC │ │ │ │ │ -88FC3CA1B0D5BAC39263B371005BCFA19AD197A31CC34D0BD55C2CA18C60C485 │ │ │ │ │ -5993F736EF1DD2C5D2B4D50B3D498861B4DF5E7AFF614BBCA4C2E6BECC0DCEF5 │ │ │ │ │ -95F0D686188014C530D8E37650CDCAE721B4AFB0F178BC744BDDDED45DAB7FEB │ │ │ │ │ -A10B975E26099E3DC61116D6BF554574F948895B88EEFE03DCC5351190836AD4 │ │ │ │ │ -EBC1AC55C6D099A8E7B0A372D290C481F44FA464B9C11A0BC991CB045E0AAAC4 │ │ │ │ │ -5C73CA43A4F17D1ADDD33D1B917FF95BFF411C8409F41553B1BC97DE47E3A1F4 │ │ │ │ │ -A5C1D1B7B1BF7E2507AC53956C141411F4F657E37981996DD7BB7ADB2CB6AE01 │ │ │ │ │ -73D0876B8F896F626D5022FE53BA34D5668BD698BE8D5CCAD083CBCEF440BE6A │ │ │ │ │ -8090EB1CDEE5F99C8988650BD4E539B357C31C597D8A9104A9D5967D4E906CAD │ │ │ │ │ -2A65575A884B1C5F6CC509E742FA9DDD66494F219178161AF72C50848E226A95 │ │ │ │ │ -A8C247FF9FF0BABD073021271B5C0692F9BE220071DAB09E5A026629371EE3C4 │ │ │ │ │ -A6E4FA94625D87A5B66EF077ED54C72B1052AEAA9637B30C76EF8EB04AD5F476 │ │ │ │ │ -D15F1C93C0BC6E0F67B366097BBED03FE82C040F9EF02866159B46854E11D44F │ │ │ │ │ -54AE6748A7E61B993A4EECD3B8BE3B5897A66BBCDFE24F65BC2AD5AB49048CF1 │ │ │ │ │ -647203823F84DF5CB483096F9D96AEE3A2855E479B72A14A67C633CE99C101CF │ │ │ │ │ -EFAE939BF9B02E710D │ │ │ │ │ +1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004ACD1870 │ │ │ │ │ +A5EA947858F5795870BFE1343AD803FB854BF8F5A4E794E8EC57BE41DB5B8734 │ │ │ │ │ +13E47950F29A81EA0C81EA798863883D7F41F78325CA190CBBFFE822AE494550 │ │ │ │ │ +4BE83703071FC9512D128927AF3F63CEF8F86ABE1E15D7B4DDD39576E7DFF45E │ │ │ │ │ +3CB4115AAB1830DE8647B915DB4BEBEB5235C281E098B899BAB951D8D5798F01 │ │ │ │ │ +7F7C47336D31438E5126738AFEAB29E9A7CBE06DE4DD604477B542D2620DFD58 │ │ │ │ │ +28FE34238572F23C5A8EB7ACEE1E154DA13FC1A5AA67A3BA8C5CDFB2B80312C9 │ │ │ │ │ +BC9FAE56D08DDFA9498E6EF0D0F6BD18B3923E0B670B0740528BC843610736CB │ │ │ │ │ +80228C105C2F72C3C22D610C3D8C268DEEA2AEEE3221E198E79FE2966487360C │ │ │ │ │ +84AE08AC326F48B21447652121B1EB68AF856055EEA65B6B625BF622CBFC2D1C │ │ │ │ │ +EF943CC4CAF2C715782C9EF9A9BA4689BFC6B6A82F8D55795BE8111E2C7DE520 │ │ │ │ │ +367362304B6A48186C842033E715A46265A352472F4F7313248EBCD26BEA97E7 │ │ │ │ │ +B814A61D4B7ADCB5C5F21AA34E0C1269E8426DBFB511DE6E26B960456C8F8520 │ │ │ │ │ +5F0DD382289A62AF0B935EDB5B2394538C5F0EE72962D2F98F3C38CD7C027B9F │ │ │ │ │ +E230E67E40FEFBDED06B3423C9DFD669E6B5BC913E0FF75786A64A6C11D4FE89 │ │ │ │ │ +1B918DC0E953C52CFD153063CD0D2A78B43F8712243845E6F2CBA1DB610F403D │ │ │ │ │ +A98D06D95FF44C7AC029092B666A8B0DCEA95B34F5ACC10E8611BADE6A24469C │ │ │ │ │ +0C01D95BFB445FA22CD38D033E4D24E006BB9D54EE41EF7AD5AC9C299721F61A │ │ │ │ │ +F01B6EDCDF428BD9195A13C5B1027358F8A203F828A1DD9622243B2D76C6F1BA │ │ │ │ │ +9F2D7E9D4879FC668ABC750CD25415DC6CCF2257C28F78D3F9BE499CC0FF2F80 │ │ │ │ │ +2C2CD1DEFABD6668FCA76E1D629A344333E33DA24B86D2E9F8F5EE1C29974640 │ │ │ │ │ +C3E78E999BAB313400041DADDDFDBFFCC419F129A84F4D412B79E8BE4511CA00 │ │ │ │ │ +F92A4F3CDD2E51345D3965C104F06B6503445DC20224CB7606A9D7D5F9EE45E6 │ │ │ │ │ +1B2963DA96AA2AB1BA5BE29656E666E4D0E122DE58EEA68E04ED76438DA03E65 │ │ │ │ │ +B80055A86B7B2A26BAE6BBB8835E17F9696E9B3CD34571BA75C76D4D2CCC48F1 │ │ │ │ │ +7534C1EF9127E374D65D05B8072E08D6C72A0B4A35EA0DD717743C66D105CCD8 │ │ │ │ │ +7355F13E9C38C1A4351624E689ED7909100942FA0474842EE44DEC3279E1A1CD │ │ │ │ │ +8064666EB845CA7C3E906B67C0BF96A28D514DB2E4A1E4AF287350B03762A2CF │ │ │ │ │ +13B18AC3F5D2F3B74A1D50267C03EFB74B888E1D24ABEEA4A885F4D0BF14C0D8 │ │ │ │ │ +289AC79D6D98E2A2C831672FB1F3457564CD161ADC3AF610D88201AB5B0C10CB │ │ │ │ │ +5ECCC2D5C4AF39C8CB3044BF9EC791BA45D29C2B51EA0483D19822C264CE6FA3 │ │ │ │ │ +5C97F2DF5A78CB93528E99B9ED7CB121C83130C129B849B52A36EBD88AF19DD3 │ │ │ │ │ +C5CABE831027388EF86BD5CBD90AAAC089775938A321C44D4DDA67A51312D8AB │ │ │ │ │ +C509DDBE7044A107AB2BE9C4C9556F85C529B174A7778B489BF28EC07A834542 │ │ │ │ │ +8B31F2925C21FB2096877711F998763D5A8495002B8E080AF8DBB1B3106EDDBA │ │ │ │ │ +35121D52E0846A7AF3ABEDF87BDE4FA665673A9B80CA538B98F873947AA17EF4 │ │ │ │ │ +9BB182917E9D79BC7EC681E93710D6A1D6B0E4A7FA9452FC1C431808174F3AB7 │ │ │ │ │ +F3914FBC86CB34E8583457243C3C7BE4BC166C7397689BC6FFB82EA2967E88EE │ │ │ │ │ +464F96EDA144DE2B64401B8E577ABCA2D826FE0B92E21FFAE3E81EBB6B6EB36E │ │ │ │ │ +9B1A8FE3884CA398C03135FD49D51724FC1268E9482E41FAEA2FC6C809006B8F │ │ │ │ │ +5D4F9E038450AD3A6041C16FD1C7E5FC80C0E033CE57E64863E014531D94DF1E │ │ │ │ │ +31D7D038AFCB60715AA73C1E96F113A24C5AF35BBEB61C4D079ED034ED83AA4A │ │ │ │ │ +E12448E618330463304788BCF40561CD63167B3BF144F408E2B89E60B8BA13EF │ │ │ │ │ +3B57D286FD23D4FA8BAEFF98DC1188B1982956CC1DCAEFC7D949B7B4E3BE8F8A │ │ │ │ │ +BFE2C9D938DD13EFEE7123576608D9396F260907DA98AE2D3DD5822306CBC8A6 │ │ │ │ │ +B083C697DDA3C62EE7879436A9FD8EE0034B105105B3F122F893EA2126EBE8A9 │ │ │ │ │ +5CBF2BD248DD9FBEF0040C25797BD13B69A8C9F0D4E4F935C61ED30487CCDB1A │ │ │ │ │ +0339006E78EE1755929D2412776EC7DB1F666DBDD28EA8AC7397F809C7F38A41 │ │ │ │ │ +5B3BF6C75F4F35C90141EB08377AF452CF840FEA938805F9D14E02DC29215B4E │ │ │ │ │ +F1EB │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ @@ -3671,16 +3662,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 23[42 19[76 18[23 2[42 2[42 1[42 42 42 3[23 │ │ │ │ │ -44[{}10 83.022 /CMSL10 rf │ │ │ │ │ +/Fe 138[46 6[46 8[37 26[43 15[23 4[42 2[42 1[42 3[23 │ │ │ │ │ +44[{}9 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 │ │ │ │ │ @@ -3803,19 +3794,19 @@ │ │ │ │ │ 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 1181 4 v │ │ │ │ │ -1346 w Fi(DenseMtx)24 b Fe(:)37 b Fh(DRAFT)27 b Fe(Ma)n(y)g(17,)g(2024) │ │ │ │ │ -p 2720 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 │ │ │ │ │ +TeXDict begin 2 1 bop 0 100 a Fj(2)p 125 100 1174 4 v │ │ │ │ │ +1339 w Fi(DenseMtx)25 b Fe(:)37 b Fh(DRAFT)27 b Fe(June)g(20,)g(2025)p │ │ │ │ │ +2726 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 │ │ │ │ │ @@ -3877,17 +3868,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 1181 4 v 1346 100 a Fi(DenseMtx)25 │ │ │ │ │ -b Fe(:)37 b Fh(DRAFT)110 b Fe(Ma)n(y)27 b(17,)f(2024)p │ │ │ │ │ -2680 100 V 1181 w Fj(3)101 390 y(5.)42 b Fi(int)g(DenseMtx_rowIncr)o │ │ │ │ │ +TeXDict begin 3 2 bop 83 100 1174 4 v 1340 100 a Fi(DenseMtx)24 │ │ │ │ │ +b Fe(:)37 b Fh(DRAFT)110 b Fe(June)28 b(20,)f(2025)p │ │ │ │ │ +2687 100 V 1174 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 │ │ │ │ │ @@ -3958,18 +3949,18 @@ │ │ │ │ │ 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 1181 4 v │ │ │ │ │ -1346 w Fi(DenseMtx)24 b Fe(:)37 b Fh(DRAFT)27 b Fe(Ma)n(y)g(17,)g(2024) │ │ │ │ │ -p 2720 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 │ │ │ │ │ +TeXDict begin 4 3 bop 0 100 a Fj(4)p 125 100 1174 4 v │ │ │ │ │ +1339 w Fi(DenseMtx)25 b Fe(:)37 b Fh(DRAFT)27 b Fe(June)g(20,)g(2025)p │ │ │ │ │ +2726 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 │ │ │ │ │ @@ -4055,17 +4046,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 1181 4 v 1346 100 a Fi(DenseMtx)25 │ │ │ │ │ -b Fe(:)37 b Fh(DRAFT)110 b Fe(Ma)n(y)27 b(17,)f(2024)p │ │ │ │ │ -2680 100 V 1181 w Fj(5)0 390 y Fc(1.2.4)112 b(Utilit)m(y)38 │ │ │ │ │ +TeXDict begin 5 4 bop 83 100 1174 4 v 1340 100 a Fi(DenseMtx)24 │ │ │ │ │ +b Fe(:)37 b Fh(DRAFT)110 b Fe(June)28 b(20,)f(2025)p │ │ │ │ │ +2687 100 V 1174 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 │ │ │ │ │ @@ -4144,17 +4135,17 @@ │ │ │ │ │ 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 1181 4 v │ │ │ │ │ -1346 w Fi(DenseMtx)24 b Fe(:)37 b Fh(DRAFT)27 b Fe(Ma)n(y)g(17,)g(2024) │ │ │ │ │ -p 2720 100 V 101 390 a Fj(9.)42 b Fi(void)f(DenseMtx_addRow)d(\()43 │ │ │ │ │ +TeXDict begin 6 5 bop 0 100 a Fj(6)p 125 100 1174 4 v │ │ │ │ │ +1339 w Fi(DenseMtx)25 b Fe(:)37 b Fh(DRAFT)27 b Fe(June)g(20,)g(2025)p │ │ │ │ │ +2726 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 │ │ │ │ │ @@ -4227,17 +4218,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 1181 4 v 1346 100 a Fi(DenseMtx)25 │ │ │ │ │ -b Fe(:)37 b Fh(DRAFT)110 b Fe(Ma)n(y)27 b(17,)f(2024)p │ │ │ │ │ -2680 100 V 1181 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 1174 4 v 1340 100 a Fi(DenseMtx)24 │ │ │ │ │ +b Fe(:)37 b Fh(DRAFT)110 b Fe(June)28 b(20,)f(2025)p │ │ │ │ │ +2687 100 V 1174 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 │ │ │ │ │ @@ -4324,19 +4315,19 @@ │ │ │ │ │ 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 1181 4 v │ │ │ │ │ -1346 w Fi(DenseMtx)24 b Fe(:)37 b Fh(DRAFT)27 b Fe(Ma)n(y)g(17,)g(2024) │ │ │ │ │ -p 2720 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 │ │ │ │ │ +TeXDict begin 8 7 bop 0 100 a Fj(8)p 125 100 1174 4 v │ │ │ │ │ +1339 w Fi(DenseMtx)25 b Fe(:)37 b Fh(DRAFT)27 b Fe(June)g(20,)g(2025)p │ │ │ │ │ +2726 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 │ │ │ │ │ ├── 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 May 17, 2024 │ │ │ │ │ │ + 2 DenseMtx : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 3 │ │ │ │ │ │ + DenseMtx : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 4 DenseMtx : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 5 │ │ │ │ │ │ + DenseMtx : DRAFT June 20, 2025 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. │ │ │ │ │ │ @@ -174,21 +174,21 @@ │ │ │ │ │ │ Error checking: If mtx is NULL, an error message is printed and the program exits. │ │ │ │ │ │ 7. void DenseMtx_copyRow ( DenseMtx *mtxB, int irowB, DenseMtx *mtxA, int irowA ) ; │ │ │ │ │ │ This method copies 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. │ │ │ │ │ │ 8. void DenseMtx_copyRowAndIndex ( DenseMtx *mtxB, int irowB, │ │ │ │ │ │ - DenseMtx *mtxA, int irowA ) ; │ │ │ │ │ │ + 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 May 17, 2024 │ │ │ │ │ │ + 6 DenseMtx : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 7 │ │ │ │ │ │ + DenseMtx : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 8 DenseMtx : DRAFT June 20, 2025 │ │ │ │ │ │ 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 2024.05.17:2217 │ │ │ │ │ +%DVIPSSource: TeX output 2025.06.20:0449 │ │ │ │ │ %%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 │ │ │ │ │ @@ -1719,22 +1719,21 @@ │ │ │ │ │ /UnderlinePosition -100 def │ │ │ │ │ /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 49 /one put │ │ │ │ │ dup 50 /two put │ │ │ │ │ -dup 52 /four put │ │ │ │ │ -dup 55 /seven put │ │ │ │ │ +dup 53 /five put │ │ │ │ │ dup 58 /colon put │ │ │ │ │ -dup 77 /M put │ │ │ │ │ -dup 97 /a put │ │ │ │ │ -dup 121 /y put │ │ │ │ │ +dup 74 /J put │ │ │ │ │ +dup 101 /e put │ │ │ │ │ +dup 110 /n put │ │ │ │ │ +dup 117 /u put │ │ │ │ │ readonly def │ │ │ │ │ currentdict end │ │ │ │ │ currentfile eexec │ │ │ │ │ D9D66F633B846AB284BCF8B0411B772DE5CE32340DC6F28AF40857E4451976E7 │ │ │ │ │ 5182433CF9F333A38BD841C0D4E68BF9E012EB32A8FFB76B5816306B5EDF7C99 │ │ │ │ │ 8B3A16D9B4BC056662E32C7CD0123DFAEB734C7532E64BBFBF5A60336E646716 │ │ │ │ │ EFB852C877F440D329172C71F1E5D59CE9473C26B8AEF7AD68EF0727B6EC2E0C │ │ │ │ │ @@ -1915,72 +1914,64 @@ │ │ │ │ │ 7CA1534C4D5B05FC33F83790ECFD7641DF3FB94289E2A1F6E7D29AB1228A867A │ │ │ │ │ 6E1EF0E9C6F899B491DC18401C2C0A05FFFED46A72C245F7529B8EA55A038082 │ │ │ │ │ 8512307217D2A233C37004085BA3AEE379269F9FA7D0ADB4B19A95CC2AFE686E │ │ │ │ │ 55D88E47257C1FE6F235FEA295910569FE6DD5995512562359CC821E85A6C7A5 │ │ │ │ │ 79B470A9E340A6985189FF8B6AF914A6B0ECF93F47903221F95DE894A8F05B05 │ │ │ │ │ B7D99CD533EC5F931B18E6B39BECF67FA2D6DD1AEC76772B068BE06335A94C05 │ │ │ │ │ 7A4DDEE77B66101DA855C17AC312600370B34E31F5EC3A01300A8EB60B4C9767 │ │ │ │ │ -1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004B9BA1CC │ │ │ │ │ -580D3C6BDA4DC1B80B4365F1C80512453FC5316EC2D928FB731C3D6403E3C18B │ │ │ │ │ -E8424D644DF5E9A2134229C5C91CA68DB8E85BA2BB40F538F585DA6FA4037718 │ │ │ │ │ -B8053EBBA1E765346BCD5BDAA6C38115D31611D8A87A2238C145F2DA2F92E4DF │ │ │ │ │ -3987BD9C4D2A3D460E8941A68B125BCD9EE4F9FD262C4C8A71F47A2C81975635 │ │ │ │ │ -F1B981C274C53FA2ACCDE4C9D0A7C62D6C1EFF91CFC6712CA6A9F333C9564FCB │ │ │ │ │ -2A70F0AD715A79B10A08AB069E2A3C93BC0AED19D0CA10134B8DDDE8AF548DB2 │ │ │ │ │ -3A4AAA9C29682CF135BB767DAA16169A127EB50A7EECEB6480CF56A7D0F8AC56 │ │ │ │ │ -4A5090B3D75A790372886AF568D94C8165975A05BFBFDF1FFBA45F70700BB9E0 │ │ │ │ │ -57F3249EF9E9C8AD9CBCF6E4FD592DC4CDD2CC7C0BC3130C1059096C657BE453 │ │ │ │ │ -A2CBACE93420210E27AF56CA229BD6D982FB68B3FDC6D44478B922C4231C47EE │ │ │ │ │ -E500232F6C11D92DEB955F66DF52B92B22E7352790CC2DCBAC53965D57AC2920 │ │ │ │ │ -68B7D520DE25047146EFEB06B9AD4E2A94243C7E5239F0BC2FC312B16051D52C │ │ │ │ │ -0B92C217B6B42997321AE4F8BB066754B7AA3F15069EF59224E8A442CE471AA7 │ │ │ │ │ -E8049A3DD9EDA09CCEE4998998661CF7DB35E952F6C65DAEB3013951C59F3E09 │ │ │ │ │ -157F313B0237876E1C0190F0473819570B8C0205AADF05D787CC00979CFB327A │ │ │ │ │ -289382B22DDA6F12804ED0ED5B179E36A995A2A59E1B66E75130DBE9109C813B │ │ │ │ │ -94403E0DEA8314A1E9DB474D7FA83C0BAFD08033E6A6215844C1D26BE15F1251 │ │ │ │ │ -A1605E8DF9A9C601ED37379530BC1C82BE5463C6C711C5652BFD6262485AA9CA │ │ │ │ │ -B8C4A117593001D08D980041E2A83C190DCE8E6CD3D334E5CC19FC05DB30F7F7 │ │ │ │ │ -24A305C4DBB31F0651392B99D44B4302333BDF7E326FD256DD75D309C6E73F85 │ │ │ │ │ -FA71B35FD1F9BEFF4C7A1076362EEB0A85492933B6006086A7B8C1928CF2D1EE │ │ │ │ │ -FD4344409257BB802C117E739960821CD3C88BFBA5669FF16F610AD638AF3677 │ │ │ │ │ -8674C985E6767253ED5769F71BEA5E9BB02A751F9E62EE2B18AC19D975FDEAE9 │ │ │ │ │ -8B8822367FF177A7E850766DE99ED3366D46464612926430012212A90F8E85F4 │ │ │ │ │ -4760B40D5B86B90819EE410382C23E86DCAF4F0FF5DFEB2C285965F4DCF2FB2B │ │ │ │ │ -457C0A0427A8D4ADA514E9DACD0F9367E1DA225DB21DA4DDAE33F2B529686D92 │ │ │ │ │ -AC085B345565F9DFFA012FD494DBB2E0B44A0787B2B72DC8D25399DAAE8864B7 │ │ │ │ │ -E84AA99DAFCEAF18F8B41882720316450F1B1CA48B418C9736E5CE4AFF996111 │ │ │ │ │ -5F7FE80958B6A3498508E9693CB134402D92E30D4C2939070D4647E13682290E │ │ │ │ │ -1D0820A3FCA7147157D09D1A40771F214EAE7DD743EA26839E535CA186C05CB8 │ │ │ │ │ -4874988AA1104D85AF0220FE7224344FF624E794BD2454E1C0AC971522FBECBA │ │ │ │ │ -B2497F25CD621B77EC5160973EF5ECC39C183DC051B0DFCB090194A2525BD96E │ │ │ │ │ -28593FDA80D8D259F039416D5F9AF0AD3C9A105B49DAF6E681921E369B7666C6 │ │ │ │ │ -2B73DB37447B00AE96317C2F1C44FB6E6EFD740BAB20FA03A8CE018EC8415582 │ │ │ │ │ -FB06E88A2971E3A480FB1EB4FE93CC7E5179721CAABEE88742B13CF0405F49F4 │ │ │ │ │ -945E587668C821D8C06D6847B6DF84CAFFCD4628670D551FC5F7236875BE1207 │ │ │ │ │ -634BA7F70A19B658FAE7D86F6D00ED28FBF29CC585DEE279325EEF8B0CCB6149 │ │ │ │ │ -E46E638C73D75148F18A636DBC2DD96ED34F68A5A09A3700B1EA34B2D142807C │ │ │ │ │ -F8709D81180783548EAE6F457BF968602076A1069163E3C15BBCEF659C6CF2E6 │ │ │ │ │ -0BB01BDC8E503802CC7969A5B8477E9788C5249B23B19669F5075E089738E49A │ │ │ │ │ -8671D7C1B1B47652F3D78BF2FF74EDB44BA5B092E8D5B85001E97F69D54AEEFC │ │ │ │ │ -88FC3CA1B0D5BAC39263B371005BCFA19AD197A31CC34D0BD55C2CA18C60C485 │ │ │ │ │ -5993F736EF1DD2C5D2B4D50B3D498861B4DF5E7AFF614BBCA4C2E6BECC0DCEF5 │ │ │ │ │ -95F0D686188014C530D8E37650CDCAE721B4AFB0F178BC744BDDDED45DAB7FEB │ │ │ │ │ -A10B975E26099E3DC61116D6BF554574F948895B88EEFE03DCC5351190836AD4 │ │ │ │ │ -EBC1AC55C6D099A8E7B0A372D290C481F44FA464B9C11A0BC991CB045E0AAAC4 │ │ │ │ │ -5C73CA43A4F17D1ADDD33D1B917FF95BFF411C8409F41553B1BC97DE47E3A1F4 │ │ │ │ │ -A5C1D1B7B1BF7E2507AC53956C141411F4F657E37981996DD7BB7ADB2CB6AE01 │ │ │ │ │ -73D0876B8F896F626D5022FE53BA34D5668BD698BE8D5CCAD083CBCEF440BE6A │ │ │ │ │ -8090EB1CDEE5F99C8988650BD4E539B357C31C597D8A9104A9D5967D4E906CAD │ │ │ │ │ -2A65575A884B1C5F6CC509E742FA9DDD66494F219178161AF72C50848E226A95 │ │ │ │ │ -A8C247FF9FF0BABD073021271B5C0692F9BE220071DAB09E5A026629371EE3C4 │ │ │ │ │ -A6E4FA94625D87A5B66EF077ED54C72B1052AEAA9637B30C76EF8EB04AD5F476 │ │ │ │ │ -D15F1C93C0BC6E0F67B366097BBED03FE82C040F9EF02866159B46854E11D44F │ │ │ │ │ -54AE6748A7E61B993A4EECD3B8BE3B5897A66BBCDFE24F65BC2AD5AB49048CF1 │ │ │ │ │ -647203823F84DF5CB483096F9D96AEE3A2855E479B72A14A67C633CE99C101CF │ │ │ │ │ -EFAE939BF9B02E710D │ │ │ │ │ +1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004ACD1870 │ │ │ │ │ +A5EA947858F5795870BFE1343AD803FB854BF8F5A4E794E8EC57BE41DB5B8734 │ │ │ │ │ +13E47950F29A81EA0C81EA798863883D7F41F78325CA190CBBFFE822AE494550 │ │ │ │ │ +4BE83703071FC9512D128927AF3F63CEF8F86ABE1E15D7B4DDD39576E7DFF45E │ │ │ │ │ +3CB4115AAB1830DE8647B915DB4BEBEB5235C281E098B899BAB951D8D5798F01 │ │ │ │ │ +7F7C47336D31438E5126738AFEAB29E9A7CBE06DE4DD604477B542D2620DFD58 │ │ │ │ │ +28FE34238572F23C5A8EB7ACEE1E154DA13FC1A5AA67A3BA8C5CDFB2B80312C9 │ │ │ │ │ +BC9FAE56D08DDFA9498E6EF0D0F6BD18B3923E0B670B0740528BC843610736CB │ │ │ │ │ +80228C105C2F72C3C22D610C3D8C268DEEA2AEEE3221E198E79FE2966487360C │ │ │ │ │ +84AE08AC326F48B21447652121B1EB68AF856055EEA65B6B625BF622CBFC2D1C │ │ │ │ │ +EF943CC4CAF2C715782C9EF9A9BA4689BFC6B6A82F8D55795BE8111E2C7DE520 │ │ │ │ │ +367362304B6A48186C842033E715A46265A352472F4F7313248EBCD26BEA97E7 │ │ │ │ │ +B814A61D4B7ADCB5C5F21AA34E0C1269E8426DBFB511DE6E26B960456C8F8520 │ │ │ │ │ +5F0DD382289A62AF0B935EDB5B2394538C5F0EE72962D2F98F3C38CD7C027B9F │ │ │ │ │ +E230E67E40FEFBDED06B3423C9DFD669E6B5BC913E0FF75786A64A6C11D4FE89 │ │ │ │ │ +1B918DC0E953C52CFD153063CD0D2A78B43F8712243845E6F2CBA1DB610F403D │ │ │ │ │ +A98D06D95FF44C7AC029092B666A8B0DCEA95B34F5ACC10E8611BADE6A24469C │ │ │ │ │ +0C01D95BFB445FA22CD38D033E4D24E006BB9D54EE41EF7AD5AC9C299721F61A │ │ │ │ │ +F01B6EDCDF428BD9195A13C5B1027358F8A203F828A1DD9622243B2D76C6F1BA │ │ │ │ │ +9F2D7E9D4879FC668ABC750CD25415DC6CCF2257C28F78D3F9BE499CC0FF2F80 │ │ │ │ │ +2C2CD1DEFABD6668FCA76E1D629A344333E33DA24B86D2E9F8F5EE1C29974640 │ │ │ │ │ +C3E78E999BAB313400041DADDDFDBFFCC419F129A84F4D412B79E8BE4511CA00 │ │ │ │ │ +F92A4F3CDD2E51345D3965C104F06B6503445DC20224CB7606A9D7D5F9EE45E6 │ │ │ │ │ +1B2963DA96AA2AB1BA5BE29656E666E4D0E122DE58EEA68E04ED76438DA03E65 │ │ │ │ │ +B80055A86B7B2A26BAE6BBB8835E17F9696E9B3CD34571BA75C76D4D2CCC48F1 │ │ │ │ │ +7534C1EF9127E374D65D05B8072E08D6C72A0B4A35EA0DD717743C66D105CCD8 │ │ │ │ │ +7355F13E9C38C1A4351624E689ED7909100942FA0474842EE44DEC3279E1A1CD │ │ │ │ │ +8064666EB845CA7C3E906B67C0BF96A28D514DB2E4A1E4AF287350B03762A2CF │ │ │ │ │ +13B18AC3F5D2F3B74A1D50267C03EFB74B888E1D24ABEEA4A885F4D0BF14C0D8 │ │ │ │ │ +289AC79D6D98E2A2C831672FB1F3457564CD161ADC3AF610D88201AB5B0C10CB │ │ │ │ │ +5ECCC2D5C4AF39C8CB3044BF9EC791BA45D29C2B51EA0483D19822C264CE6FA3 │ │ │ │ │ +5C97F2DF5A78CB93528E99B9ED7CB121C83130C129B849B52A36EBD88AF19DD3 │ │ │ │ │ +C5CABE831027388EF86BD5CBD90AAAC089775938A321C44D4DDA67A51312D8AB │ │ │ │ │ +C509DDBE7044A107AB2BE9C4C9556F85C529B174A7778B489BF28EC07A834542 │ │ │ │ │ +8B31F2925C21FB2096877711F998763D5A8495002B8E080AF8DBB1B3106EDDBA │ │ │ │ │ +35121D52E0846A7AF3ABEDF87BDE4FA665673A9B80CA538B98F873947AA17EF4 │ │ │ │ │ +9BB182917E9D79BC7EC681E93710D6A1D6B0E4A7FA9452FC1C431808174F3AB7 │ │ │ │ │ +F3914FBC86CB34E8583457243C3C7BE4BC166C7397689BC6FFB82EA2967E88EE │ │ │ │ │ +464F96EDA144DE2B64401B8E577ABCA2D826FE0B92E21FFAE3E81EBB6B6EB36E │ │ │ │ │ +9B1A8FE3884CA398C03135FD49D51724FC1268E9482E41FAEA2FC6C809006B8F │ │ │ │ │ +5D4F9E038450AD3A6041C16FD1C7E5FC80C0E033CE57E64863E014531D94DF1E │ │ │ │ │ +31D7D038AFCB60715AA73C1E96F113A24C5AF35BBEB61C4D079ED034ED83AA4A │ │ │ │ │ +E12448E618330463304788BCF40561CD63167B3BF144F408E2B89E60B8BA13EF │ │ │ │ │ +3B57D286FD23D4FA8BAEFF98DC1188B1982956CC1DCAEFC7D949B7B4E3BE8F8A │ │ │ │ │ +BFE2C9D938DD13EFEE7123576608D9396F260907DA98AE2D3DD5822306CBC8A6 │ │ │ │ │ +B083C697DDA3C62EE7879436A9FD8EE0034B105105B3F122F893EA2126EBE8A9 │ │ │ │ │ +5CBF2BD248DD9FBEF0040C25797BD13B69A8C9F0D4E4F935C61ED30487CCDB1A │ │ │ │ │ +0339006E78EE1755929D2412776EC7DB1F666DBDD28EA8AC7397F809C7F38A41 │ │ │ │ │ +5B3BF6C75F4F35C90141EB08377AF452CF840FEA938805F9D14E02DC29215B4E │ │ │ │ │ +F1EB │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ @@ -3591,17 +3582,17 @@ │ │ │ │ │ %%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 23[45 19[83 18[25 2[45 2[45 1[45 │ │ │ │ │ -45 45 3[25 44[{}10 90.9091 /CMSL10 rf /Fe 141[62 3[62 │ │ │ │ │ -9[62 2[62 28[62 68[{}5 119.552 /CMTT12 rf │ │ │ │ │ +/CMTI10 rf /Fd 138[51 6[51 8[40 26[47 15[25 4[45 2[45 │ │ │ │ │ +1[45 3[25 44[{}9 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 │ │ │ │ │ {/.notdef}repeat/dollar/.notdef/.notdef/quotesingle/.notdef/.notdef │ │ │ │ │ @@ -3692,17 +3683,17 @@ │ │ │ │ │ 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 1179 4 v │ │ │ │ │ -1361 w Fh(Drand)29 b Fd(:)40 b Fc(DRAFT)31 b Fd(Ma)m(y)g(17,)h(2024)p │ │ │ │ │ -2721 100 V 0 399 a Fb(1.2.1)112 b(Basic)38 b(metho)s(ds)0 │ │ │ │ │ +TeXDict begin 2 1 bop 0 100 a Fj(2)p 136 100 1172 4 v │ │ │ │ │ +1354 w Fh(Drand)29 b Fd(:)41 b Fc(DRAFT)30 b Fd(June)f(20,)j(2025)p │ │ │ │ │ +2728 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) │ │ │ │ │ @@ -3750,17 +3741,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 1179 4 v 1360 100 a Fh(Drand)29 │ │ │ │ │ -b Fd(:)41 b Fc(DRAFT)121 b Fd(Ma)m(y)32 b(17,)f(2024)p │ │ │ │ │ -2674 100 V 1179 w Fj(3)111 399 y(3.)46 b Fh(void)h(Drand_setSeeds)d(\() │ │ │ │ │ +TeXDict begin 3 2 bop 91 100 1172 4 v 1353 100 a Fh(Drand)29 │ │ │ │ │ +b Fd(:)41 b Fc(DRAFT)121 b Fd(June)30 b(20,)h(2025)p │ │ │ │ │ +2681 100 V 1172 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 │ │ │ │ │ @@ -3815,17 +3806,17 @@ │ │ │ │ │ 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 1179 4 v │ │ │ │ │ -1361 w Fh(Drand)29 b Fd(:)40 b Fc(DRAFT)31 b Fd(Ma)m(y)g(17,)h(2024)p │ │ │ │ │ -2721 100 V 111 399 a Fj(1.)46 b Fh(testDrand)g(msglvl)g(msgFile)f │ │ │ │ │ +TeXDict begin 4 3 bop 0 100 a Fj(4)p 136 100 1172 4 v │ │ │ │ │ +1354 w Fh(Drand)29 b Fd(:)41 b Fc(DRAFT)30 b Fd(June)f(20,)j(2025)p │ │ │ │ │ +2728 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) │ │ │ │ │ ├── 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 May 17, 2024 │ │ │ │ │ │ + 2 Drand : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 3 │ │ │ │ │ │ + Drand : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 4 Drand : DRAFT June 20, 2025 │ │ │ │ │ │ 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 2024.05.17:2217 │ │ │ │ │ +%DVIPSSource: TeX output 2025.06.20:0449 │ │ │ │ │ %%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 │ │ │ │ │ @@ -1405,22 +1405,21 @@ │ │ │ │ │ /UnderlinePosition -100 def │ │ │ │ │ /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 49 /one put │ │ │ │ │ dup 50 /two put │ │ │ │ │ -dup 52 /four put │ │ │ │ │ -dup 55 /seven put │ │ │ │ │ +dup 53 /five put │ │ │ │ │ dup 58 /colon put │ │ │ │ │ -dup 77 /M put │ │ │ │ │ -dup 97 /a put │ │ │ │ │ -dup 121 /y put │ │ │ │ │ +dup 74 /J put │ │ │ │ │ +dup 101 /e put │ │ │ │ │ +dup 110 /n put │ │ │ │ │ +dup 117 /u put │ │ │ │ │ readonly def │ │ │ │ │ currentdict end │ │ │ │ │ currentfile eexec │ │ │ │ │ D9D66F633B846AB284BCF8B0411B772DE5CE32340DC6F28AF40857E4451976E7 │ │ │ │ │ 5182433CF9F333A38BD841C0D4E68BF9E012EB32A8FFB76B5816306B5EDF7C99 │ │ │ │ │ 8B3A16D9B4BC056662E32C7CD0123DFAEB734C7532E64BBFBF5A60336E646716 │ │ │ │ │ EFB852C877F440D329172C71F1E5D59CE9473C26B8AEF7AD68EF0727B6EC2E0C │ │ │ │ │ @@ -1601,72 +1600,64 @@ │ │ │ │ │ 7CA1534C4D5B05FC33F83790ECFD7641DF3FB94289E2A1F6E7D29AB1228A867A │ │ │ │ │ 6E1EF0E9C6F899B491DC18401C2C0A05FFFED46A72C245F7529B8EA55A038082 │ │ │ │ │ 8512307217D2A233C37004085BA3AEE379269F9FA7D0ADB4B19A95CC2AFE686E │ │ │ │ │ 55D88E47257C1FE6F235FEA295910569FE6DD5995512562359CC821E85A6C7A5 │ │ │ │ │ 79B470A9E340A6985189FF8B6AF914A6B0ECF93F47903221F95DE894A8F05B05 │ │ │ │ │ B7D99CD533EC5F931B18E6B39BECF67FA2D6DD1AEC76772B068BE06335A94C05 │ │ │ │ │ 7A4DDEE77B66101DA855C17AC312600370B34E31F5EC3A01300A8EB60B4C9767 │ │ │ │ │ -1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004B9BA1CC │ │ │ │ │ -580D3C6BDA4DC1B80B4365F1C80512453FC5316EC2D928FB731C3D6403E3C18B │ │ │ │ │ -E8424D644DF5E9A2134229C5C91CA68DB8E85BA2BB40F538F585DA6FA4037718 │ │ │ │ │ -B8053EBBA1E765346BCD5BDAA6C38115D31611D8A87A2238C145F2DA2F92E4DF │ │ │ │ │ -3987BD9C4D2A3D460E8941A68B125BCD9EE4F9FD262C4C8A71F47A2C81975635 │ │ │ │ │ -F1B981C274C53FA2ACCDE4C9D0A7C62D6C1EFF91CFC6712CA6A9F333C9564FCB │ │ │ │ │ -2A70F0AD715A79B10A08AB069E2A3C93BC0AED19D0CA10134B8DDDE8AF548DB2 │ │ │ │ │ -3A4AAA9C29682CF135BB767DAA16169A127EB50A7EECEB6480CF56A7D0F8AC56 │ │ │ │ │ -4A5090B3D75A790372886AF568D94C8165975A05BFBFDF1FFBA45F70700BB9E0 │ │ │ │ │ -57F3249EF9E9C8AD9CBCF6E4FD592DC4CDD2CC7C0BC3130C1059096C657BE453 │ │ │ │ │ -A2CBACE93420210E27AF56CA229BD6D982FB68B3FDC6D44478B922C4231C47EE │ │ │ │ │ -E500232F6C11D92DEB955F66DF52B92B22E7352790CC2DCBAC53965D57AC2920 │ │ │ │ │ -68B7D520DE25047146EFEB06B9AD4E2A94243C7E5239F0BC2FC312B16051D52C │ │ │ │ │ -0B92C217B6B42997321AE4F8BB066754B7AA3F15069EF59224E8A442CE471AA7 │ │ │ │ │ -E8049A3DD9EDA09CCEE4998998661CF7DB35E952F6C65DAEB3013951C59F3E09 │ │ │ │ │ -157F313B0237876E1C0190F0473819570B8C0205AADF05D787CC00979CFB327A │ │ │ │ │ -289382B22DDA6F12804ED0ED5B179E36A995A2A59E1B66E75130DBE9109C813B │ │ │ │ │ -94403E0DEA8314A1E9DB474D7FA83C0BAFD08033E6A6215844C1D26BE15F1251 │ │ │ │ │ -A1605E8DF9A9C601ED37379530BC1C82BE5463C6C711C5652BFD6262485AA9CA │ │ │ │ │ -B8C4A117593001D08D980041E2A83C190DCE8E6CD3D334E5CC19FC05DB30F7F7 │ │ │ │ │ -24A305C4DBB31F0651392B99D44B4302333BDF7E326FD256DD75D309C6E73F85 │ │ │ │ │ -FA71B35FD1F9BEFF4C7A1076362EEB0A85492933B6006086A7B8C1928CF2D1EE │ │ │ │ │ -FD4344409257BB802C117E739960821CD3C88BFBA5669FF16F610AD638AF3677 │ │ │ │ │ -8674C985E6767253ED5769F71BEA5E9BB02A751F9E62EE2B18AC19D975FDEAE9 │ │ │ │ │ -8B8822367FF177A7E850766DE99ED3366D46464612926430012212A90F8E85F4 │ │ │ │ │ -4760B40D5B86B90819EE410382C23E86DCAF4F0FF5DFEB2C285965F4DCF2FB2B │ │ │ │ │ -457C0A0427A8D4ADA514E9DACD0F9367E1DA225DB21DA4DDAE33F2B529686D92 │ │ │ │ │ -AC085B345565F9DFFA012FD494DBB2E0B44A0787B2B72DC8D25399DAAE8864B7 │ │ │ │ │ -E84AA99DAFCEAF18F8B41882720316450F1B1CA48B418C9736E5CE4AFF996111 │ │ │ │ │ -5F7FE80958B6A3498508E9693CB134402D92E30D4C2939070D4647E13682290E │ │ │ │ │ -1D0820A3FCA7147157D09D1A40771F214EAE7DD743EA26839E535CA186C05CB8 │ │ │ │ │ -4874988AA1104D85AF0220FE7224344FF624E794BD2454E1C0AC971522FBECBA │ │ │ │ │ -B2497F25CD621B77EC5160973EF5ECC39C183DC051B0DFCB090194A2525BD96E │ │ │ │ │ -28593FDA80D8D259F039416D5F9AF0AD3C9A105B49DAF6E681921E369B7666C6 │ │ │ │ │ -2B73DB37447B00AE96317C2F1C44FB6E6EFD740BAB20FA03A8CE018EC8415582 │ │ │ │ │ -FB06E88A2971E3A480FB1EB4FE93CC7E5179721CAABEE88742B13CF0405F49F4 │ │ │ │ │ -945E587668C821D8C06D6847B6DF84CAFFCD4628670D551FC5F7236875BE1207 │ │ │ │ │ -634BA7F70A19B658FAE7D86F6D00ED28FBF29CC585DEE279325EEF8B0CCB6149 │ │ │ │ │ -E46E638C73D75148F18A636DBC2DD96ED34F68A5A09A3700B1EA34B2D142807C │ │ │ │ │ -F8709D81180783548EAE6F457BF968602076A1069163E3C15BBCEF659C6CF2E6 │ │ │ │ │ -0BB01BDC8E503802CC7969A5B8477E9788C5249B23B19669F5075E089738E49A │ │ │ │ │ -8671D7C1B1B47652F3D78BF2FF74EDB44BA5B092E8D5B85001E97F69D54AEEFC │ │ │ │ │ -88FC3CA1B0D5BAC39263B371005BCFA19AD197A31CC34D0BD55C2CA18C60C485 │ │ │ │ │ -5993F736EF1DD2C5D2B4D50B3D498861B4DF5E7AFF614BBCA4C2E6BECC0DCEF5 │ │ │ │ │ -95F0D686188014C530D8E37650CDCAE721B4AFB0F178BC744BDDDED45DAB7FEB │ │ │ │ │ -A10B975E26099E3DC61116D6BF554574F948895B88EEFE03DCC5351190836AD4 │ │ │ │ │ -EBC1AC55C6D099A8E7B0A372D290C481F44FA464B9C11A0BC991CB045E0AAAC4 │ │ │ │ │ -5C73CA43A4F17D1ADDD33D1B917FF95BFF411C8409F41553B1BC97DE47E3A1F4 │ │ │ │ │ -A5C1D1B7B1BF7E2507AC53956C141411F4F657E37981996DD7BB7ADB2CB6AE01 │ │ │ │ │ -73D0876B8F896F626D5022FE53BA34D5668BD698BE8D5CCAD083CBCEF440BE6A │ │ │ │ │ -8090EB1CDEE5F99C8988650BD4E539B357C31C597D8A9104A9D5967D4E906CAD │ │ │ │ │ -2A65575A884B1C5F6CC509E742FA9DDD66494F219178161AF72C50848E226A95 │ │ │ │ │ -A8C247FF9FF0BABD073021271B5C0692F9BE220071DAB09E5A026629371EE3C4 │ │ │ │ │ -A6E4FA94625D87A5B66EF077ED54C72B1052AEAA9637B30C76EF8EB04AD5F476 │ │ │ │ │ -D15F1C93C0BC6E0F67B366097BBED03FE82C040F9EF02866159B46854E11D44F │ │ │ │ │ -54AE6748A7E61B993A4EECD3B8BE3B5897A66BBCDFE24F65BC2AD5AB49048CF1 │ │ │ │ │ -647203823F84DF5CB483096F9D96AEE3A2855E479B72A14A67C633CE99C101CF │ │ │ │ │ -EFAE939BF9B02E710D │ │ │ │ │ +1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004ACD1870 │ │ │ │ │ +A5EA947858F5795870BFE1343AD803FB854BF8F5A4E794E8EC57BE41DB5B8734 │ │ │ │ │ +13E47950F29A81EA0C81EA798863883D7F41F78325CA190CBBFFE822AE494550 │ │ │ │ │ +4BE83703071FC9512D128927AF3F63CEF8F86ABE1E15D7B4DDD39576E7DFF45E │ │ │ │ │ +3CB4115AAB1830DE8647B915DB4BEBEB5235C281E098B899BAB951D8D5798F01 │ │ │ │ │ +7F7C47336D31438E5126738AFEAB29E9A7CBE06DE4DD604477B542D2620DFD58 │ │ │ │ │ +28FE34238572F23C5A8EB7ACEE1E154DA13FC1A5AA67A3BA8C5CDFB2B80312C9 │ │ │ │ │ +BC9FAE56D08DDFA9498E6EF0D0F6BD18B3923E0B670B0740528BC843610736CB │ │ │ │ │ +80228C105C2F72C3C22D610C3D8C268DEEA2AEEE3221E198E79FE2966487360C │ │ │ │ │ +84AE08AC326F48B21447652121B1EB68AF856055EEA65B6B625BF622CBFC2D1C │ │ │ │ │ +EF943CC4CAF2C715782C9EF9A9BA4689BFC6B6A82F8D55795BE8111E2C7DE520 │ │ │ │ │ +367362304B6A48186C842033E715A46265A352472F4F7313248EBCD26BEA97E7 │ │ │ │ │ +B814A61D4B7ADCB5C5F21AA34E0C1269E8426DBFB511DE6E26B960456C8F8520 │ │ │ │ │ +5F0DD382289A62AF0B935EDB5B2394538C5F0EE72962D2F98F3C38CD7C027B9F │ │ │ │ │ +E230E67E40FEFBDED06B3423C9DFD669E6B5BC913E0FF75786A64A6C11D4FE89 │ │ │ │ │ +1B918DC0E953C52CFD153063CD0D2A78B43F8712243845E6F2CBA1DB610F403D │ │ │ │ │ +A98D06D95FF44C7AC029092B666A8B0DCEA95B34F5ACC10E8611BADE6A24469C │ │ │ │ │ +0C01D95BFB445FA22CD38D033E4D24E006BB9D54EE41EF7AD5AC9C299721F61A │ │ │ │ │ +F01B6EDCDF428BD9195A13C5B1027358F8A203F828A1DD9622243B2D76C6F1BA │ │ │ │ │ +9F2D7E9D4879FC668ABC750CD25415DC6CCF2257C28F78D3F9BE499CC0FF2F80 │ │ │ │ │ +2C2CD1DEFABD6668FCA76E1D629A344333E33DA24B86D2E9F8F5EE1C29974640 │ │ │ │ │ +C3E78E999BAB313400041DADDDFDBFFCC419F129A84F4D412B79E8BE4511CA00 │ │ │ │ │ +F92A4F3CDD2E51345D3965C104F06B6503445DC20224CB7606A9D7D5F9EE45E6 │ │ │ │ │ +1B2963DA96AA2AB1BA5BE29656E666E4D0E122DE58EEA68E04ED76438DA03E65 │ │ │ │ │ +B80055A86B7B2A26BAE6BBB8835E17F9696E9B3CD34571BA75C76D4D2CCC48F1 │ │ │ │ │ +7534C1EF9127E374D65D05B8072E08D6C72A0B4A35EA0DD717743C66D105CCD8 │ │ │ │ │ +7355F13E9C38C1A4351624E689ED7909100942FA0474842EE44DEC3279E1A1CD │ │ │ │ │ +8064666EB845CA7C3E906B67C0BF96A28D514DB2E4A1E4AF287350B03762A2CF │ │ │ │ │ +13B18AC3F5D2F3B74A1D50267C03EFB74B888E1D24ABEEA4A885F4D0BF14C0D8 │ │ │ │ │ +289AC79D6D98E2A2C831672FB1F3457564CD161ADC3AF610D88201AB5B0C10CB │ │ │ │ │ +5ECCC2D5C4AF39C8CB3044BF9EC791BA45D29C2B51EA0483D19822C264CE6FA3 │ │ │ │ │ +5C97F2DF5A78CB93528E99B9ED7CB121C83130C129B849B52A36EBD88AF19DD3 │ │ │ │ │ +C5CABE831027388EF86BD5CBD90AAAC089775938A321C44D4DDA67A51312D8AB │ │ │ │ │ +C509DDBE7044A107AB2BE9C4C9556F85C529B174A7778B489BF28EC07A834542 │ │ │ │ │ +8B31F2925C21FB2096877711F998763D5A8495002B8E080AF8DBB1B3106EDDBA │ │ │ │ │ +35121D52E0846A7AF3ABEDF87BDE4FA665673A9B80CA538B98F873947AA17EF4 │ │ │ │ │ +9BB182917E9D79BC7EC681E93710D6A1D6B0E4A7FA9452FC1C431808174F3AB7 │ │ │ │ │ +F3914FBC86CB34E8583457243C3C7BE4BC166C7397689BC6FFB82EA2967E88EE │ │ │ │ │ +464F96EDA144DE2B64401B8E577ABCA2D826FE0B92E21FFAE3E81EBB6B6EB36E │ │ │ │ │ +9B1A8FE3884CA398C03135FD49D51724FC1268E9482E41FAEA2FC6C809006B8F │ │ │ │ │ +5D4F9E038450AD3A6041C16FD1C7E5FC80C0E033CE57E64863E014531D94DF1E │ │ │ │ │ +31D7D038AFCB60715AA73C1E96F113A24C5AF35BBEB61C4D079ED034ED83AA4A │ │ │ │ │ +E12448E618330463304788BCF40561CD63167B3BF144F408E2B89E60B8BA13EF │ │ │ │ │ +3B57D286FD23D4FA8BAEFF98DC1188B1982956CC1DCAEFC7D949B7B4E3BE8F8A │ │ │ │ │ +BFE2C9D938DD13EFEE7123576608D9396F260907DA98AE2D3DD5822306CBC8A6 │ │ │ │ │ +B083C697DDA3C62EE7879436A9FD8EE0034B105105B3F122F893EA2126EBE8A9 │ │ │ │ │ +5CBF2BD248DD9FBEF0040C25797BD13B69A8C9F0D4E4F935C61ED30487CCDB1A │ │ │ │ │ +0339006E78EE1755929D2412776EC7DB1F666DBDD28EA8AC7397F809C7F38A41 │ │ │ │ │ +5B3BF6C75F4F35C90141EB08377AF452CF840FEA938805F9D14E02DC29215B4E │ │ │ │ │ +F1EB │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ @@ -3886,16 +3877,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 23[45 19[83 18[25 2[45 2[45 1[45 │ │ │ │ │ -45 45 3[25 44[{}10 90.9091 /CMSL10 rf │ │ │ │ │ +/CMTT12 rf /Fd 138[51 6[51 8[40 26[47 15[25 4[45 2[45 │ │ │ │ │ +1[45 3[25 44[{}9 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 │ │ │ │ │ @@ -4015,17 +4006,17 @@ │ │ │ │ │ (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 1155 4 v │ │ │ │ │ -1337 w Fj(EGraph)29 b Fd(:)40 b Fg(DRAFT)31 b Fd(Ma)m(y)g(17,)h(2024)p │ │ │ │ │ -2745 100 V 0 399 a Ff(1.2)135 b(Protot)l(yp)t(es)46 b(and)f │ │ │ │ │ +TeXDict begin 2 1 bop 0 100 a Fk(2)p 136 100 1148 4 v │ │ │ │ │ +1330 w Fj(EGraph)29 b Fd(:)40 b Fg(DRAFT)31 b Fd(June)e(20,)i(2025)p │ │ │ │ │ +2752 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 │ │ │ │ │ @@ -4085,17 +4076,17 @@ │ │ │ │ │ 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 1155 4 v 1337 100 a Fj(EGraph)28 │ │ │ │ │ -b Fd(:)41 b Fg(DRAFT)121 b Fd(Ma)m(y)32 b(17,)f(2024)p │ │ │ │ │ -2698 100 V 1155 w Fk(3)0 399 y Fb(1.2.3)112 b(Utilit)m(y)38 │ │ │ │ │ +TeXDict begin 3 2 bop 91 100 1148 4 v 1330 100 a Fj(EGraph)28 │ │ │ │ │ +b Fd(:)41 b Fg(DRAFT)121 b Fd(June)29 b(20,)j(2025)p │ │ │ │ │ +2705 100 V 1148 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 │ │ │ │ │ @@ -4167,17 +4158,17 @@ │ │ │ │ │ 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 1155 4 v │ │ │ │ │ -1337 w Fj(EGraph)29 b Fd(:)40 b Fg(DRAFT)31 b Fd(Ma)m(y)g(17,)h(2024)p │ │ │ │ │ -2745 100 V 111 399 a Fk(4.)46 b Fj(int)h(EGraph_writeToFile)c(\()k │ │ │ │ │ +TeXDict begin 4 3 bop 0 100 a Fk(4)p 136 100 1148 4 v │ │ │ │ │ +1330 w Fj(EGraph)29 b Fd(:)40 b Fg(DRAFT)31 b Fd(June)e(20,)i(2025)p │ │ │ │ │ +2752 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 │ │ │ │ │ @@ -4248,17 +4239,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 1155 4 v 1337 100 a Fj(EGraph)28 │ │ │ │ │ -b Fd(:)41 b Fg(DRAFT)121 b Fd(Ma)m(y)32 b(17,)f(2024)p │ │ │ │ │ -2698 100 V 1155 w Fk(5)337 399 y Fe(\210)45 b Fk(The)35 │ │ │ │ │ +TeXDict begin 5 4 bop 91 100 1148 4 v 1330 100 a Fj(EGraph)28 │ │ │ │ │ +b Fd(:)41 b Fg(DRAFT)121 b Fd(June)29 b(20,)j(2025)p │ │ │ │ │ +2705 100 V 1148 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 │ │ │ │ │ @@ -4330,17 +4321,17 @@ │ │ │ │ │ (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 1155 4 v │ │ │ │ │ -1337 w Fj(EGraph)29 b Fd(:)40 b Fg(DRAFT)31 b Fd(Ma)m(y)g(17,)h(2024)p │ │ │ │ │ -2745 100 V 337 399 a Fe(\210)45 b Fk(The)20 b Fj(outEGraphFile)d │ │ │ │ │ +TeXDict begin 6 5 bop 0 100 a Fk(6)p 136 100 1148 4 v │ │ │ │ │ +1330 w Fj(EGraph)29 b Fd(:)40 b Fg(DRAFT)31 b Fd(June)e(20,)i(2025)p │ │ │ │ │ +2752 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 │ │ │ │ │ ├── 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 May 17, 2024 │ │ │ │ │ │ + 2 EGraph : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 3 │ │ │ │ │ │ + EGraph : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 4 EGraph : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 5 │ │ │ │ │ │ + EGraph : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 6 EGraph : DRAFT June 20, 2025 │ │ │ │ │ │ • 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 2024.05.17:2217 │ │ │ │ │ +%DVIPSSource: TeX output 2025.06.20:0449 │ │ │ │ │ %%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 │ │ │ │ │ @@ -3605,22 +3605,21 @@ │ │ │ │ │ /UnderlinePosition -100 def │ │ │ │ │ /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 49 /one put │ │ │ │ │ dup 50 /two put │ │ │ │ │ -dup 52 /four put │ │ │ │ │ -dup 55 /seven put │ │ │ │ │ +dup 53 /five put │ │ │ │ │ dup 58 /colon put │ │ │ │ │ -dup 77 /M put │ │ │ │ │ -dup 97 /a put │ │ │ │ │ -dup 121 /y put │ │ │ │ │ +dup 74 /J put │ │ │ │ │ +dup 101 /e put │ │ │ │ │ +dup 110 /n put │ │ │ │ │ +dup 117 /u put │ │ │ │ │ readonly def │ │ │ │ │ currentdict end │ │ │ │ │ currentfile eexec │ │ │ │ │ D9D66F633B846AB284BCF8B0411B772DE5CE32340DC6F28AF40857E4451976E7 │ │ │ │ │ 5182433CF9F333A38BD841C0D4E68BF9E012EB32A8FFB76B5816306B5EDF7C99 │ │ │ │ │ 8B3A16D9B4BC056662E32C7CD0123DFAEB734C7532E64BBFBF5A60336E646716 │ │ │ │ │ EFB852C877F440D329172C71F1E5D59CE9473C26B8AEF7AD68EF0727B6EC2E0C │ │ │ │ │ @@ -3801,72 +3800,64 @@ │ │ │ │ │ 7CA1534C4D5B05FC33F83790ECFD7641DF3FB94289E2A1F6E7D29AB1228A867A │ │ │ │ │ 6E1EF0E9C6F899B491DC18401C2C0A05FFFED46A72C245F7529B8EA55A038082 │ │ │ │ │ 8512307217D2A233C37004085BA3AEE379269F9FA7D0ADB4B19A95CC2AFE686E │ │ │ │ │ 55D88E47257C1FE6F235FEA295910569FE6DD5995512562359CC821E85A6C7A5 │ │ │ │ │ 79B470A9E340A6985189FF8B6AF914A6B0ECF93F47903221F95DE894A8F05B05 │ │ │ │ │ B7D99CD533EC5F931B18E6B39BECF67FA2D6DD1AEC76772B068BE06335A94C05 │ │ │ │ │ 7A4DDEE77B66101DA855C17AC312600370B34E31F5EC3A01300A8EB60B4C9767 │ │ │ │ │ -1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004B9BA1CC │ │ │ │ │ -580D3C6BDA4DC1B80B4365F1C80512453FC5316EC2D928FB731C3D6403E3C18B │ │ │ │ │ -E8424D644DF5E9A2134229C5C91CA68DB8E85BA2BB40F538F585DA6FA4037718 │ │ │ │ │ -B8053EBBA1E765346BCD5BDAA6C38115D31611D8A87A2238C145F2DA2F92E4DF │ │ │ │ │ -3987BD9C4D2A3D460E8941A68B125BCD9EE4F9FD262C4C8A71F47A2C81975635 │ │ │ │ │ -F1B981C274C53FA2ACCDE4C9D0A7C62D6C1EFF91CFC6712CA6A9F333C9564FCB │ │ │ │ │ -2A70F0AD715A79B10A08AB069E2A3C93BC0AED19D0CA10134B8DDDE8AF548DB2 │ │ │ │ │ -3A4AAA9C29682CF135BB767DAA16169A127EB50A7EECEB6480CF56A7D0F8AC56 │ │ │ │ │ -4A5090B3D75A790372886AF568D94C8165975A05BFBFDF1FFBA45F70700BB9E0 │ │ │ │ │ -57F3249EF9E9C8AD9CBCF6E4FD592DC4CDD2CC7C0BC3130C1059096C657BE453 │ │ │ │ │ -A2CBACE93420210E27AF56CA229BD6D982FB68B3FDC6D44478B922C4231C47EE │ │ │ │ │ -E500232F6C11D92DEB955F66DF52B92B22E7352790CC2DCBAC53965D57AC2920 │ │ │ │ │ -68B7D520DE25047146EFEB06B9AD4E2A94243C7E5239F0BC2FC312B16051D52C │ │ │ │ │ -0B92C217B6B42997321AE4F8BB066754B7AA3F15069EF59224E8A442CE471AA7 │ │ │ │ │ -E8049A3DD9EDA09CCEE4998998661CF7DB35E952F6C65DAEB3013951C59F3E09 │ │ │ │ │ -157F313B0237876E1C0190F0473819570B8C0205AADF05D787CC00979CFB327A │ │ │ │ │ -289382B22DDA6F12804ED0ED5B179E36A995A2A59E1B66E75130DBE9109C813B │ │ │ │ │ -94403E0DEA8314A1E9DB474D7FA83C0BAFD08033E6A6215844C1D26BE15F1251 │ │ │ │ │ -A1605E8DF9A9C601ED37379530BC1C82BE5463C6C711C5652BFD6262485AA9CA │ │ │ │ │ -B8C4A117593001D08D980041E2A83C190DCE8E6CD3D334E5CC19FC05DB30F7F7 │ │ │ │ │ -24A305C4DBB31F0651392B99D44B4302333BDF7E326FD256DD75D309C6E73F85 │ │ │ │ │ -FA71B35FD1F9BEFF4C7A1076362EEB0A85492933B6006086A7B8C1928CF2D1EE │ │ │ │ │ -FD4344409257BB802C117E739960821CD3C88BFBA5669FF16F610AD638AF3677 │ │ │ │ │ -8674C985E6767253ED5769F71BEA5E9BB02A751F9E62EE2B18AC19D975FDEAE9 │ │ │ │ │ -8B8822367FF177A7E850766DE99ED3366D46464612926430012212A90F8E85F4 │ │ │ │ │ -4760B40D5B86B90819EE410382C23E86DCAF4F0FF5DFEB2C285965F4DCF2FB2B │ │ │ │ │ -457C0A0427A8D4ADA514E9DACD0F9367E1DA225DB21DA4DDAE33F2B529686D92 │ │ │ │ │ -AC085B345565F9DFFA012FD494DBB2E0B44A0787B2B72DC8D25399DAAE8864B7 │ │ │ │ │ -E84AA99DAFCEAF18F8B41882720316450F1B1CA48B418C9736E5CE4AFF996111 │ │ │ │ │ -5F7FE80958B6A3498508E9693CB134402D92E30D4C2939070D4647E13682290E │ │ │ │ │ -1D0820A3FCA7147157D09D1A40771F214EAE7DD743EA26839E535CA186C05CB8 │ │ │ │ │ -4874988AA1104D85AF0220FE7224344FF624E794BD2454E1C0AC971522FBECBA │ │ │ │ │ -B2497F25CD621B77EC5160973EF5ECC39C183DC051B0DFCB090194A2525BD96E │ │ │ │ │ -28593FDA80D8D259F039416D5F9AF0AD3C9A105B49DAF6E681921E369B7666C6 │ │ │ │ │ -2B73DB37447B00AE96317C2F1C44FB6E6EFD740BAB20FA03A8CE018EC8415582 │ │ │ │ │ -FB06E88A2971E3A480FB1EB4FE93CC7E5179721CAABEE88742B13CF0405F49F4 │ │ │ │ │ -945E587668C821D8C06D6847B6DF84CAFFCD4628670D551FC5F7236875BE1207 │ │ │ │ │ -634BA7F70A19B658FAE7D86F6D00ED28FBF29CC585DEE279325EEF8B0CCB6149 │ │ │ │ │ -E46E638C73D75148F18A636DBC2DD96ED34F68A5A09A3700B1EA34B2D142807C │ │ │ │ │ -F8709D81180783548EAE6F457BF968602076A1069163E3C15BBCEF659C6CF2E6 │ │ │ │ │ -0BB01BDC8E503802CC7969A5B8477E9788C5249B23B19669F5075E089738E49A │ │ │ │ │ -8671D7C1B1B47652F3D78BF2FF74EDB44BA5B092E8D5B85001E97F69D54AEEFC │ │ │ │ │ -88FC3CA1B0D5BAC39263B371005BCFA19AD197A31CC34D0BD55C2CA18C60C485 │ │ │ │ │ -5993F736EF1DD2C5D2B4D50B3D498861B4DF5E7AFF614BBCA4C2E6BECC0DCEF5 │ │ │ │ │ -95F0D686188014C530D8E37650CDCAE721B4AFB0F178BC744BDDDED45DAB7FEB │ │ │ │ │ -A10B975E26099E3DC61116D6BF554574F948895B88EEFE03DCC5351190836AD4 │ │ │ │ │ -EBC1AC55C6D099A8E7B0A372D290C481F44FA464B9C11A0BC991CB045E0AAAC4 │ │ │ │ │ -5C73CA43A4F17D1ADDD33D1B917FF95BFF411C8409F41553B1BC97DE47E3A1F4 │ │ │ │ │ -A5C1D1B7B1BF7E2507AC53956C141411F4F657E37981996DD7BB7ADB2CB6AE01 │ │ │ │ │ -73D0876B8F896F626D5022FE53BA34D5668BD698BE8D5CCAD083CBCEF440BE6A │ │ │ │ │ -8090EB1CDEE5F99C8988650BD4E539B357C31C597D8A9104A9D5967D4E906CAD │ │ │ │ │ -2A65575A884B1C5F6CC509E742FA9DDD66494F219178161AF72C50848E226A95 │ │ │ │ │ -A8C247FF9FF0BABD073021271B5C0692F9BE220071DAB09E5A026629371EE3C4 │ │ │ │ │ -A6E4FA94625D87A5B66EF077ED54C72B1052AEAA9637B30C76EF8EB04AD5F476 │ │ │ │ │ -D15F1C93C0BC6E0F67B366097BBED03FE82C040F9EF02866159B46854E11D44F │ │ │ │ │ -54AE6748A7E61B993A4EECD3B8BE3B5897A66BBCDFE24F65BC2AD5AB49048CF1 │ │ │ │ │ -647203823F84DF5CB483096F9D96AEE3A2855E479B72A14A67C633CE99C101CF │ │ │ │ │ -EFAE939BF9B02E710D │ │ │ │ │ +1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004ACD1870 │ │ │ │ │ +A5EA947858F5795870BFE1343AD803FB854BF8F5A4E794E8EC57BE41DB5B8734 │ │ │ │ │ +13E47950F29A81EA0C81EA798863883D7F41F78325CA190CBBFFE822AE494550 │ │ │ │ │ +4BE83703071FC9512D128927AF3F63CEF8F86ABE1E15D7B4DDD39576E7DFF45E │ │ │ │ │ +3CB4115AAB1830DE8647B915DB4BEBEB5235C281E098B899BAB951D8D5798F01 │ │ │ │ │ +7F7C47336D31438E5126738AFEAB29E9A7CBE06DE4DD604477B542D2620DFD58 │ │ │ │ │ +28FE34238572F23C5A8EB7ACEE1E154DA13FC1A5AA67A3BA8C5CDFB2B80312C9 │ │ │ │ │ +BC9FAE56D08DDFA9498E6EF0D0F6BD18B3923E0B670B0740528BC843610736CB │ │ │ │ │ +80228C105C2F72C3C22D610C3D8C268DEEA2AEEE3221E198E79FE2966487360C │ │ │ │ │ +84AE08AC326F48B21447652121B1EB68AF856055EEA65B6B625BF622CBFC2D1C │ │ │ │ │ +EF943CC4CAF2C715782C9EF9A9BA4689BFC6B6A82F8D55795BE8111E2C7DE520 │ │ │ │ │ +367362304B6A48186C842033E715A46265A352472F4F7313248EBCD26BEA97E7 │ │ │ │ │ +B814A61D4B7ADCB5C5F21AA34E0C1269E8426DBFB511DE6E26B960456C8F8520 │ │ │ │ │ +5F0DD382289A62AF0B935EDB5B2394538C5F0EE72962D2F98F3C38CD7C027B9F │ │ │ │ │ +E230E67E40FEFBDED06B3423C9DFD669E6B5BC913E0FF75786A64A6C11D4FE89 │ │ │ │ │ +1B918DC0E953C52CFD153063CD0D2A78B43F8712243845E6F2CBA1DB610F403D │ │ │ │ │ +A98D06D95FF44C7AC029092B666A8B0DCEA95B34F5ACC10E8611BADE6A24469C │ │ │ │ │ +0C01D95BFB445FA22CD38D033E4D24E006BB9D54EE41EF7AD5AC9C299721F61A │ │ │ │ │ +F01B6EDCDF428BD9195A13C5B1027358F8A203F828A1DD9622243B2D76C6F1BA │ │ │ │ │ +9F2D7E9D4879FC668ABC750CD25415DC6CCF2257C28F78D3F9BE499CC0FF2F80 │ │ │ │ │ +2C2CD1DEFABD6668FCA76E1D629A344333E33DA24B86D2E9F8F5EE1C29974640 │ │ │ │ │ +C3E78E999BAB313400041DADDDFDBFFCC419F129A84F4D412B79E8BE4511CA00 │ │ │ │ │ +F92A4F3CDD2E51345D3965C104F06B6503445DC20224CB7606A9D7D5F9EE45E6 │ │ │ │ │ +1B2963DA96AA2AB1BA5BE29656E666E4D0E122DE58EEA68E04ED76438DA03E65 │ │ │ │ │ +B80055A86B7B2A26BAE6BBB8835E17F9696E9B3CD34571BA75C76D4D2CCC48F1 │ │ │ │ │ +7534C1EF9127E374D65D05B8072E08D6C72A0B4A35EA0DD717743C66D105CCD8 │ │ │ │ │ +7355F13E9C38C1A4351624E689ED7909100942FA0474842EE44DEC3279E1A1CD │ │ │ │ │ +8064666EB845CA7C3E906B67C0BF96A28D514DB2E4A1E4AF287350B03762A2CF │ │ │ │ │ +13B18AC3F5D2F3B74A1D50267C03EFB74B888E1D24ABEEA4A885F4D0BF14C0D8 │ │ │ │ │ +289AC79D6D98E2A2C831672FB1F3457564CD161ADC3AF610D88201AB5B0C10CB │ │ │ │ │ +5ECCC2D5C4AF39C8CB3044BF9EC791BA45D29C2B51EA0483D19822C264CE6FA3 │ │ │ │ │ +5C97F2DF5A78CB93528E99B9ED7CB121C83130C129B849B52A36EBD88AF19DD3 │ │ │ │ │ +C5CABE831027388EF86BD5CBD90AAAC089775938A321C44D4DDA67A51312D8AB │ │ │ │ │ +C509DDBE7044A107AB2BE9C4C9556F85C529B174A7778B489BF28EC07A834542 │ │ │ │ │ +8B31F2925C21FB2096877711F998763D5A8495002B8E080AF8DBB1B3106EDDBA │ │ │ │ │ +35121D52E0846A7AF3ABEDF87BDE4FA665673A9B80CA538B98F873947AA17EF4 │ │ │ │ │ +9BB182917E9D79BC7EC681E93710D6A1D6B0E4A7FA9452FC1C431808174F3AB7 │ │ │ │ │ +F3914FBC86CB34E8583457243C3C7BE4BC166C7397689BC6FFB82EA2967E88EE │ │ │ │ │ +464F96EDA144DE2B64401B8E577ABCA2D826FE0B92E21FFAE3E81EBB6B6EB36E │ │ │ │ │ +9B1A8FE3884CA398C03135FD49D51724FC1268E9482E41FAEA2FC6C809006B8F │ │ │ │ │ +5D4F9E038450AD3A6041C16FD1C7E5FC80C0E033CE57E64863E014531D94DF1E │ │ │ │ │ +31D7D038AFCB60715AA73C1E96F113A24C5AF35BBEB61C4D079ED034ED83AA4A │ │ │ │ │ +E12448E618330463304788BCF40561CD63167B3BF144F408E2B89E60B8BA13EF │ │ │ │ │ +3B57D286FD23D4FA8BAEFF98DC1188B1982956CC1DCAEFC7D949B7B4E3BE8F8A │ │ │ │ │ +BFE2C9D938DD13EFEE7123576608D9396F260907DA98AE2D3DD5822306CBC8A6 │ │ │ │ │ +B083C697DDA3C62EE7879436A9FD8EE0034B105105B3F122F893EA2126EBE8A9 │ │ │ │ │ +5CBF2BD248DD9FBEF0040C25797BD13B69A8C9F0D4E4F935C61ED30487CCDB1A │ │ │ │ │ +0339006E78EE1755929D2412776EC7DB1F666DBDD28EA8AC7397F809C7F38A41 │ │ │ │ │ +5B3BF6C75F4F35C90141EB08377AF452CF840FEA938805F9D14E02DC29215B4E │ │ │ │ │ +F1EB │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ @@ -5408,16 +5399,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 23[45 19[83 18[25 2[45 2[45 1[45 │ │ │ │ │ -45 45 3[25 44[{}10 90.9091 /CMSL10 rf │ │ │ │ │ +/CMTI10 rf /Fk 138[51 6[51 8[40 26[47 15[25 4[45 2[45 │ │ │ │ │ +1[45 3[25 44[{}9 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 │ │ │ │ │ @@ -5530,17 +5521,17 @@ │ │ │ │ │ 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 1179 4 v │ │ │ │ │ -1361 w Fn(ETree)29 b Fk(:)40 b Fj(DRAFT)31 b Fk(Ma)m(y)g(17,)h(2024)p │ │ │ │ │ -2721 100 V 137 399 a Fl(\210)45 b Fn(IV)i(*vtxToFrontIV)35 │ │ │ │ │ +TeXDict begin 2 1 bop 0 100 a Fo(2)p 136 100 1172 4 v │ │ │ │ │ +1354 w Fn(ETree)29 b Fk(:)41 b Fj(DRAFT)30 b Fk(June)f(20,)j(2025)p │ │ │ │ │ +2728 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 │ │ │ │ │ @@ -5593,17 +5584,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 1179 4 v 1360 100 a Fn(ETree)29 │ │ │ │ │ -b Fk(:)41 b Fj(DRAFT)121 b Fk(Ma)m(y)32 b(17,)f(2024)p │ │ │ │ │ -2674 100 V 1179 w Fo(3)111 399 y(2.)46 b Fn(int)h(ETree_nvtx)e(\()j │ │ │ │ │ +TeXDict begin 3 2 bop 91 100 1172 4 v 1353 100 a Fn(ETree)29 │ │ │ │ │ +b Fk(:)41 b Fj(DRAFT)121 b Fk(June)30 b(20,)h(2025)p │ │ │ │ │ +2681 100 V 1172 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 │ │ │ │ │ @@ -5651,17 +5642,17 @@ │ │ │ │ │ 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 1179 4 v │ │ │ │ │ -1361 w Fn(ETree)29 b Fk(:)40 b Fj(DRAFT)31 b Fk(Ma)m(y)g(17,)h(2024)p │ │ │ │ │ -2721 100 V 66 399 a Fo(11.)46 b Fn(int)h(*)h(ETree_bndwghts)c(\()j │ │ │ │ │ +TeXDict begin 4 3 bop 0 100 a Fo(4)p 136 100 1172 4 v │ │ │ │ │ +1354 w Fn(ETree)29 b Fk(:)41 b Fj(DRAFT)30 b Fk(June)f(20,)j(2025)p │ │ │ │ │ +2728 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 │ │ │ │ │ @@ -5719,17 +5710,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 1179 4 v 1360 100 a Fn(ETree)29 │ │ │ │ │ -b Fk(:)41 b Fj(DRAFT)121 b Fk(Ma)m(y)32 b(17,)f(2024)p │ │ │ │ │ -2674 100 V 1179 w Fo(5)227 399 y(with)j(a)g(call)i(to)e │ │ │ │ │ +TeXDict begin 5 4 bop 91 100 1172 4 v 1353 100 a Fn(ETree)29 │ │ │ │ │ +b Fk(:)41 b Fj(DRAFT)121 b Fk(June)30 b(20,)h(2025)p │ │ │ │ │ +2681 100 V 1172 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 │ │ │ │ │ @@ -5807,17 +5798,17 @@ │ │ │ │ │ 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 1179 4 v │ │ │ │ │ -1361 w Fn(ETree)29 b Fk(:)40 b Fj(DRAFT)31 b Fk(Ma)m(y)g(17,)h(2024)p │ │ │ │ │ -2721 100 V 227 399 a Fj(R)-5 b(eturn)40 b(c)-5 b(o)g(de:)111 │ │ │ │ │ +TeXDict begin 6 5 bop 0 100 a Fo(6)p 136 100 1172 4 v │ │ │ │ │ +1354 w Fn(ETree)29 b Fk(:)41 b Fj(DRAFT)30 b Fk(June)f(20,)j(2025)p │ │ │ │ │ +2728 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) │ │ │ │ │ @@ -5892,17 +5883,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 1179 4 v 1360 100 a Fn(ETree)29 │ │ │ │ │ -b Fk(:)41 b Fj(DRAFT)121 b Fk(Ma)m(y)32 b(17,)f(2024)p │ │ │ │ │ -2674 100 V 1179 w Fo(7)111 399 y(6.)46 b Fn(double)g │ │ │ │ │ +TeXDict begin 7 6 bop 91 100 1172 4 v 1353 100 a Fn(ETree)29 │ │ │ │ │ +b Fk(:)41 b Fj(DRAFT)121 b Fk(June)30 b(20,)h(2025)p │ │ │ │ │ +2681 100 V 1172 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 │ │ │ │ │ @@ -5988,17 +5979,17 @@ │ │ │ │ │ 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 1179 4 v │ │ │ │ │ -1361 w Fn(ETree)29 b Fk(:)40 b Fj(DRAFT)31 b Fk(Ma)m(y)g(17,)h(2024)p │ │ │ │ │ -2721 100 V 66 399 a Fo(12.)46 b Fn(ETree)h(*)g(ETree_spliceTwoEtrees)42 │ │ │ │ │ +TeXDict begin 8 7 bop 0 100 a Fo(8)p 136 100 1172 4 v │ │ │ │ │ +1354 w Fn(ETree)29 b Fk(:)41 b Fj(DRAFT)30 b Fk(June)f(20,)j(2025)p │ │ │ │ │ +2728 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 │ │ │ │ │ @@ -6066,17 +6057,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 1179 4 v 1360 100 a Fn(ETree)29 │ │ │ │ │ -b Fk(:)41 b Fj(DRAFT)121 b Fk(Ma)m(y)32 b(17,)f(2024)p │ │ │ │ │ -2674 100 V 1179 w Fo(9)0 399 y Fh(1.2.6)112 b(Compression)39 │ │ │ │ │ +TeXDict begin 9 8 bop 91 100 1172 4 v 1353 100 a Fn(ETree)29 │ │ │ │ │ +b Fk(:)41 b Fj(DRAFT)121 b Fk(June)30 b(20,)h(2025)p │ │ │ │ │ +2681 100 V 1172 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 │ │ │ │ │ @@ -6144,17 +6135,17 @@ │ │ │ │ │ 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 1156 4 │ │ │ │ │ -v 1339 w Fn(ETree)29 b Fk(:)40 b Fj(DRAFT)30 b Fk(Ma)m(y)i(17,)f(2024)p │ │ │ │ │ -2744 100 V 111 399 a Fo(3.)46 b Fn(ETree)h(*)g(ETree_compress)d(\()j │ │ │ │ │ +TeXDict begin 10 9 bop 0 100 a Fo(10)p 182 100 1149 4 │ │ │ │ │ +v 1332 w Fn(ETree)29 b Fk(:)40 b Fj(DRAFT)30 b Fk(June)g(20,)h(2025)p │ │ │ │ │ +2751 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 │ │ │ │ │ @@ -6218,17 +6209,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 1156 4 v 1338 100 a Fn(ETree)29 │ │ │ │ │ -b Fk(:)40 b Fj(DRAFT)121 b Fk(Ma)m(y)32 b(17,)f(2024)p │ │ │ │ │ -2651 100 V 1156 w Fo(11)111 399 y(2.)46 b Fn(IV)h(*)h │ │ │ │ │ +TeXDict begin 11 10 bop 91 100 1149 4 v 1331 100 a Fn(ETree)29 │ │ │ │ │ +b Fk(:)40 b Fj(DRAFT)121 b Fk(June)30 b(20,)h(2025)p │ │ │ │ │ +2658 100 V 1149 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 │ │ │ │ │ @@ -6300,26 +6291,26 @@ │ │ │ │ │ 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 1156 │ │ │ │ │ -4 v 1339 w Fn(ETree)29 b Fk(:)40 b Fj(DRAFT)30 b Fk(Ma)m(y)i(17,)f │ │ │ │ │ -(2024)p 2744 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 │ │ │ │ │ +TeXDict begin 12 11 bop 0 100 a Fo(12)p 182 100 1149 │ │ │ │ │ +4 v 1332 w Fn(ETree)29 b Fk(:)40 b Fj(DRAFT)30 b Fk(June)g(20,)h(2025)p │ │ │ │ │ +2751 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 │ │ │ │ │ Fg(<)h Fo(1,)35 b(or)f(if)f Fn(nvtx)d Fg(<)g Fo(1,)35 │ │ │ │ │ b(or)e(if)h Fn(symflag)e Fo(is)h(in)m(v)-5 b(alid,)227 │ │ │ │ │ 1018 y(an)31 b(error)f(message)h(is)f(prin)m(ted)g(and)g(the)h(program) │ │ │ │ │ f(exits.)111 1239 y(4.)46 b Fn(IV)h(*)h(ETree_msByNopsCutoff)42 │ │ │ │ │ b(\()48 b(ETree)e(*etree,)g(double)g(cutoff,)g(int)h(type,)f(int)h │ │ │ │ │ @@ -6403,17 +6394,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 1156 4 v 1338 100 a Fn(ETree)29 │ │ │ │ │ -b Fk(:)40 b Fj(DRAFT)121 b Fk(Ma)m(y)32 b(17,)f(2024)p │ │ │ │ │ -2651 100 V 1156 w Fo(13)0 399 y Fh(1.2.10)113 b(T)-9 │ │ │ │ │ +TeXDict begin 13 12 bop 91 100 1149 4 v 1331 100 a Fn(ETree)29 │ │ │ │ │ +b Fk(:)40 b Fj(DRAFT)121 b Fk(June)30 b(20,)h(2025)p │ │ │ │ │ +2658 100 V 1149 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 │ │ │ │ │ @@ -6502,60 +6493,60 @@ │ │ │ │ │ (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 1156 │ │ │ │ │ -4 v 1339 w Fn(ETree)29 b Fk(:)40 b Fj(DRAFT)30 b Fk(Ma)m(y)i(17,)f │ │ │ │ │ -(2024)p 2744 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 │ │ │ │ │ -b Fn(ETree)h(*)g(ETree_mergeFrontsAll)42 b(\()48 b(ETree)e(*etree,)g │ │ │ │ │ -(int)h(maxzeros)e(\))j(;)227 1717 y Fo(This)33 b(metho)s(d)g(only)g │ │ │ │ │ -(tries)h(to)g(merge)g(a)g(fron)m(t)f(with)g(all)h(of)g(its)g(c)m │ │ │ │ │ -(hildren.)49 b(It)34 b(returns)e(an)h Fn(ETree)f Fo(ob)5 │ │ │ │ │ -b(ject)227 1830 y(where)36 b(a)g(fron)m(t)f(has)h(either)g(b)s(een)f │ │ │ │ │ -(merged)h(with)f(none)h(or)g(all)g(of)g(its)g(c)m(hildren.)57 │ │ │ │ │ -b(The)35 b(parameter)h(that)227 1943 y(go)m(v)m(erns)c(the)g(merging)f │ │ │ │ │ -(pro)s(cess)f(is)i Fn(maxzeros)p Fo(,)d(the)i(n)m(um)m(b)s(er)f(of)h │ │ │ │ │ -(zero)g(en)m(tries)h(that)g(can)f(b)s(e)g(in)m(tro)s(duced)227 │ │ │ │ │ -2055 y(b)m(y)d(merging)g(the)h(c)m(hildren)e(and)h(paren)m(t)g(fron)m │ │ │ │ │ -(t)g(together.)41 b(On)27 b(input,)h Fn(nzerosIV)e Fo(con)m(tains)j │ │ │ │ │ -(the)f(n)m(um)m(b)s(er)227 2168 y(of)35 b(zeros)h(presen)m(tly)f(in)g │ │ │ │ │ -(eac)m(h)h(fron)m(t.)54 b(It)35 b(is)g(mo)s(di\014ed)e(on)i(output)g │ │ │ │ │ -(to)g(corresp)s(ond)f(with)g(the)h(new)g(fron)m(t)227 │ │ │ │ │ -2281 y(tree.)227 2432 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 2545 │ │ │ │ │ -y(and)k(the)h(program)f(exits.)111 2733 y(3.)46 b Fn(ETree)h(*)g │ │ │ │ │ -(ETree_mergeFrontsAny)42 b(\()48 b(ETree)e(*etree,)g(int)h(maxzeros)e │ │ │ │ │ -(\))j(;)227 2884 y Fo(This)30 b(metho)s(d)g(only)h(tries)h(to)f(merge)g │ │ │ │ │ -(a)h(fron)m(t)e(with)h(an)m(y)g(subset)f(of)h(its)g(c)m(hildren.)42 │ │ │ │ │ +TeXDict begin 14 13 bop 0 100 a Fo(14)p 182 100 1149 │ │ │ │ │ +4 v 1332 w Fn(ETree)29 b Fk(:)40 b Fj(DRAFT)30 b Fk(June)g(20,)h(2025)p │ │ │ │ │ +2751 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 b Fn(ETree)h(*)g(ETree_mergeFrontsAll)42 │ │ │ │ │ +b(\()48 b(ETree)e(*etree,)g(int)h(maxzeros)e(\))j(;)227 │ │ │ │ │ +1717 y Fo(This)33 b(metho)s(d)g(only)g(tries)h(to)g(merge)g(a)g(fron)m │ │ │ │ │ +(t)f(with)g(all)h(of)g(its)g(c)m(hildren.)49 b(It)34 │ │ │ │ │ +b(returns)e(an)h Fn(ETree)f Fo(ob)5 b(ject)227 1830 y(where)36 │ │ │ │ │ +b(a)g(fron)m(t)f(has)h(either)g(b)s(een)f(merged)h(with)f(none)h(or)g │ │ │ │ │ +(all)g(of)g(its)g(c)m(hildren.)57 b(The)35 b(parameter)h(that)227 │ │ │ │ │ +1943 y(go)m(v)m(erns)c(the)g(merging)f(pro)s(cess)f(is)i │ │ │ │ │ +Fn(maxzeros)p Fo(,)d(the)i(n)m(um)m(b)s(er)f(of)h(zero)g(en)m(tries)h │ │ │ │ │ +(that)g(can)f(b)s(e)g(in)m(tro)s(duced)227 2055 y(b)m(y)d(merging)g │ │ │ │ │ +(the)h(c)m(hildren)e(and)h(paren)m(t)g(fron)m(t)g(together.)41 │ │ │ │ │ +b(On)27 b(input,)h Fn(nzerosIV)e Fo(con)m(tains)j(the)f(n)m(um)m(b)s │ │ │ │ │ +(er)227 2168 y(of)35 b(zeros)h(presen)m(tly)f(in)g(eac)m(h)h(fron)m(t.) │ │ │ │ │ +54 b(It)35 b(is)g(mo)s(di\014ed)e(on)i(output)g(to)g(corresp)s(ond)f │ │ │ │ │ +(with)g(the)h(new)g(fron)m(t)227 2281 y(tree.)227 2432 │ │ │ │ │ +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 2545 y(and)k(the)h(program)f(exits.)111 │ │ │ │ │ +2733 y(3.)46 b Fn(ETree)h(*)g(ETree_mergeFrontsAny)42 │ │ │ │ │ +b(\()48 b(ETree)e(*etree,)g(int)h(maxzeros)e(\))j(;)227 │ │ │ │ │ +2884 y Fo(This)30 b(metho)s(d)g(only)h(tries)h(to)f(merge)g(a)h(fron)m │ │ │ │ │ +(t)e(with)h(an)m(y)g(subset)f(of)h(its)g(c)m(hildren.)42 │ │ │ │ │ b(It)31 b(returns)f(an)g Fn(ETree)227 2997 y Fo(ob)5 │ │ │ │ │ b(ject)46 b(where)e(a)h(fron)m(t)f(has)h(p)s(ossibly)e(merged)i(with)f │ │ │ │ │ (an)m(y)h(of)g(its)g(c)m(hildren.)83 b(The)44 b(parameter)h(that)227 │ │ │ │ │ 3110 y(go)m(v)m(erns)32 b(the)g(merging)f(pro)s(cess)f(is)i │ │ │ │ │ Fn(maxzeros)p Fo(,)d(the)i(n)m(um)m(b)s(er)f(of)h(zero)g(en)m(tries)h │ │ │ │ │ (that)g(can)f(b)s(e)g(in)m(tro)s(duced)227 3223 y(b)m(y)d(merging)g │ │ │ │ │ (the)h(c)m(hildren)e(and)h(paren)m(t)g(fron)m(t)g(together.)41 │ │ │ │ │ @@ -6592,17 +6583,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 1156 4 v 1338 100 a Fn(ETree)29 │ │ │ │ │ -b Fk(:)40 b Fj(DRAFT)121 b Fk(Ma)m(y)32 b(17,)f(2024)p │ │ │ │ │ -2651 100 V 1156 w Fo(15)227 399 y Fn(ETree)47 b(*)g(ETree_transform2)c │ │ │ │ │ +TeXDict begin 15 14 bop 91 100 1149 4 v 1331 100 a Fn(ETree)29 │ │ │ │ │ +b Fk(:)40 b Fj(DRAFT)121 b Fk(June)30 b(20,)h(2025)p │ │ │ │ │ +2658 100 V 1149 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 │ │ │ │ │ @@ -6667,51 +6658,50 @@ │ │ │ │ │ 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 1156 │ │ │ │ │ -4 v 1339 w Fn(ETree)29 b Fk(:)40 b Fj(DRAFT)30 b Fk(Ma)m(y)i(17,)f │ │ │ │ │ -(2024)p 2744 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 1149 │ │ │ │ │ +4 v 1332 w Fn(ETree)29 b Fk(:)40 b Fj(DRAFT)30 b Fk(June)g(20,)h(2025)p │ │ │ │ │ +2751 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 │ │ │ │ │ @@ -6746,17 +6736,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 1156 4 v 1338 100 a Fn(ETree)29 │ │ │ │ │ -b Fk(:)40 b Fj(DRAFT)121 b Fk(Ma)m(y)32 b(17,)f(2024)p │ │ │ │ │ -2651 100 V 1156 w Fo(17)111 399 y(5.)46 b Fn(void)h │ │ │ │ │ +TeXDict begin 17 16 bop 91 100 1149 4 v 1331 100 a Fn(ETree)29 │ │ │ │ │ +b Fk(:)40 b Fj(DRAFT)121 b Fk(June)30 b(20,)h(2025)p │ │ │ │ │ +2658 100 V 1149 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 │ │ │ │ │ @@ -6830,66 +6820,65 @@ │ │ │ │ │ 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 1156 │ │ │ │ │ -4 v 1339 w Fn(ETree)29 b Fk(:)40 b Fj(DRAFT)30 b Fk(Ma)m(y)i(17,)f │ │ │ │ │ -(2024)p 2744 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 │ │ │ │ │ -(prin)m(ted)f(and)f(zero)j(is)e(returned.)111 1033 y(7.)46 │ │ │ │ │ -b Fn(int)h(ETree_writeForHumanEye)42 b(\()47 b(ETree)g(*etree,)f(FILE)g │ │ │ │ │ -(*fp)h(\))h(;)227 1192 y Fo(This)34 b(metho)s(d)g(writes)h(an)f │ │ │ │ │ -Fn(ETree)f Fo(ob)5 b(ject)36 b(to)f(a)g(\014le)g(in)f(a)h(readable)g │ │ │ │ │ -(format.)54 b(Otherwise,)36 b(the)e(metho)s(d)227 1305 │ │ │ │ │ -y Fn(ETree)p 473 1305 29 4 v 33 w(writeStats\(\))c Fo(is)j(called)h(to) │ │ │ │ │ -f(write)g(out)h(the)f(header)f(and)h(statistics.)50 b(Then)32 │ │ │ │ │ -b(the)h(paren)m(t,)h(\014rst)227 1418 y(c)m(hild,)e(sibling,)g(no)s(de) │ │ │ │ │ -f(w)m(eigh)m(t)h(and)f(b)s(oundary)e(w)m(eigh)m(t)k(v)-5 │ │ │ │ │ -b(alues)31 b(are)h(prin)m(ted)f(out)g(in)g(\014v)m(e)h(columns.)42 │ │ │ │ │ -b(The)227 1531 y(v)-5 b(alue)31 b Fn(1)f Fo(is)h(returned.)227 │ │ │ │ │ -1690 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)e Fo(an)i(error)f │ │ │ │ │ -(message)h(is)g(prin)m(ted)e(and)h(zero)h(is)g(returned.)111 │ │ │ │ │ -1894 y(8.)46 b Fn(int)h(ETree_writeStats)d(\()j(ETree)f(*etree,)g(FILE) │ │ │ │ │ -h(*fp)g(\))g(;)227 2053 y Fo(This)30 b(metho)s(d)g(write)g(a)h(header)f │ │ │ │ │ -(and)g(some)h(statistics)h(to)f(a)g(\014le.)41 b(The)30 │ │ │ │ │ -b(v)-5 b(alue)30 b Fn(1)g Fo(is)h(returned.)227 2212 │ │ │ │ │ -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)e Fo(an)i(error)f(message)h │ │ │ │ │ -(is)g(prin)m(ted)e(and)h(zero)h(is)g(returned.)0 2547 │ │ │ │ │ -y Fm(1.3)135 b(Driv)l(er)46 b(programs)g(for)f(the)g │ │ │ │ │ -Fi(ETree)d Fm(ob)7 b(ject)0 2783 y Fo(This)30 b(section)h(con)m(tains)h │ │ │ │ │ -(brief)e(descriptions)g(of)g(the)h(driv)m(er)f(programs.)111 │ │ │ │ │ -3042 y(1.)46 b Fn(createETree)f(msglvl)h(msgFile)g(inGraphFile)f │ │ │ │ │ -(inPermFile)g(outIVfile)g(outETreeFile)227 3200 y Fo(This)21 │ │ │ │ │ -b(driv)m(er)g(program)g(reads)g(in)g(a)h Fn(Graph)e Fo(ob)5 │ │ │ │ │ -b(ject)22 b(and)f(a)h Fn(Perm)e Fo(p)s(erm)m(utation)h(ob)5 │ │ │ │ │ -b(ject)23 b(and)d(creates)j(a)f(fron)m(t)227 3313 y(tree)34 │ │ │ │ │ -b Fn(ETree)e Fo(ob)5 b(ject.)50 b(The)33 b(map)f(from)h(v)m(ertices)i │ │ │ │ │ -(to)f(fron)m(ts)f(is)g(optionally)i(written)e(out)g(to)h │ │ │ │ │ -Fn(outIVfile)p Fo(.)227 3426 y(The)c Fn(ETree)f Fo(ob)5 │ │ │ │ │ -b(ject)31 b(is)g(optionally)h(written)e(out)h(to)g Fn(outETreeFile)p │ │ │ │ │ -Fo(.)337 3660 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 3773 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 3927 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 │ │ │ │ │ +TeXDict begin 18 17 bop 0 100 a Fo(18)p 182 100 1149 │ │ │ │ │ +4 v 1332 w Fn(ETree)29 b Fk(:)40 b Fj(DRAFT)30 b Fk(June)g(20,)h(2025)p │ │ │ │ │ +2751 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(prin)m(ted)f(and)f(zero)j(is)e(returned.)111 │ │ │ │ │ +1033 y(7.)46 b Fn(int)h(ETree_writeForHumanEye)42 b(\()47 │ │ │ │ │ +b(ETree)g(*etree,)f(FILE)g(*fp)h(\))h(;)227 1192 y Fo(This)34 │ │ │ │ │ +b(metho)s(d)g(writes)h(an)f Fn(ETree)f Fo(ob)5 b(ject)36 │ │ │ │ │ +b(to)f(a)g(\014le)g(in)f(a)h(readable)g(format.)54 b(Otherwise,)36 │ │ │ │ │ +b(the)e(metho)s(d)227 1305 y Fn(ETree)p 473 1305 29 4 │ │ │ │ │ +v 33 w(writeStats\(\))c Fo(is)j(called)h(to)f(write)g(out)h(the)f │ │ │ │ │ +(header)f(and)h(statistics.)50 b(Then)32 b(the)h(paren)m(t,)h(\014rst) │ │ │ │ │ +227 1418 y(c)m(hild,)e(sibling,)g(no)s(de)f(w)m(eigh)m(t)h(and)f(b)s │ │ │ │ │ +(oundary)e(w)m(eigh)m(t)k(v)-5 b(alues)31 b(are)h(prin)m(ted)f(out)g │ │ │ │ │ +(in)g(\014v)m(e)h(columns.)42 b(The)227 1531 y(v)-5 b(alue)31 │ │ │ │ │ +b Fn(1)f Fo(is)h(returned.)227 1690 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)e Fo(an)i(error)f(message)h(is)g(prin)m(ted)e │ │ │ │ │ +(and)h(zero)h(is)g(returned.)111 1894 y(8.)46 b Fn(int)h │ │ │ │ │ +(ETree_writeStats)d(\()j(ETree)f(*etree,)g(FILE)h(*fp)g(\))g(;)227 │ │ │ │ │ +2053 y Fo(This)30 b(metho)s(d)g(write)g(a)h(header)f(and)g(some)h │ │ │ │ │ +(statistics)h(to)f(a)g(\014le.)41 b(The)30 b(v)-5 b(alue)30 │ │ │ │ │ +b Fn(1)g Fo(is)h(returned.)227 2212 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)e Fo(an)i(error)f(message)h(is)g(prin)m(ted)e │ │ │ │ │ +(and)h(zero)h(is)g(returned.)0 2547 y Fm(1.3)135 b(Driv)l(er)46 │ │ │ │ │ +b(programs)g(for)f(the)g Fi(ETree)d Fm(ob)7 b(ject)0 │ │ │ │ │ +2783 y Fo(This)30 b(section)h(con)m(tains)h(brief)e(descriptions)g(of)g │ │ │ │ │ +(the)h(driv)m(er)f(programs.)111 3042 y(1.)46 b Fn(createETree)f │ │ │ │ │ +(msglvl)h(msgFile)g(inGraphFile)f(inPermFile)g(outIVfile)g │ │ │ │ │ +(outETreeFile)227 3200 y Fo(This)21 b(driv)m(er)g(program)g(reads)g(in) │ │ │ │ │ +g(a)h Fn(Graph)e Fo(ob)5 b(ject)22 b(and)f(a)h Fn(Perm)e │ │ │ │ │ +Fo(p)s(erm)m(utation)h(ob)5 b(ject)23 b(and)d(creates)j(a)f(fron)m(t) │ │ │ │ │ +227 3313 y(tree)34 b Fn(ETree)e Fo(ob)5 b(ject.)50 b(The)33 │ │ │ │ │ +b(map)f(from)h(v)m(ertices)i(to)f(fron)m(ts)f(is)g(optionally)i │ │ │ │ │ +(written)e(out)g(to)h Fn(outIVfile)p Fo(.)227 3426 y(The)c │ │ │ │ │ +Fn(ETree)f Fo(ob)5 b(ject)31 b(is)g(optionally)h(written)e(out)h(to)g │ │ │ │ │ +Fn(outETreeFile)p Fo(.)337 3660 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 │ │ │ │ │ +3773 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 3927 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 │ │ │ │ │ 4040 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 4153 │ │ │ │ │ y(data.)337 4308 y Fl(\210)45 b Fo(The)23 b Fn(inGraphFile)d │ │ │ │ │ Fo(parameter)k(is)f(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 4421 y Fn(*.graphf)18 b Fo(or)j Fn(*.graphb)p │ │ │ │ │ @@ -6911,17 +6900,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 1156 4 v 1338 100 a Fn(ETree)29 │ │ │ │ │ -b Fk(:)40 b Fj(DRAFT)121 b Fk(Ma)m(y)32 b(17,)f(2024)p │ │ │ │ │ -2651 100 V 1156 w Fo(19)337 399 y Fl(\210)45 b Fo(The)24 │ │ │ │ │ +TeXDict begin 19 18 bop 91 100 1149 4 v 1331 100 a Fn(ETree)29 │ │ │ │ │ +b Fk(:)40 b Fj(DRAFT)121 b Fk(June)30 b(20,)h(2025)p │ │ │ │ │ +2658 100 V 1149 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 │ │ │ │ │ @@ -6993,23 +6982,23 @@ │ │ │ │ │ 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 1156 │ │ │ │ │ -4 v 1339 w Fn(ETree)29 b Fk(:)40 b Fj(DRAFT)30 b Fk(Ma)m(y)i(17,)f │ │ │ │ │ -(2024)p 2744 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 │ │ │ │ │ +TeXDict begin 20 19 bop 0 100 a Fo(20)p 182 100 1149 │ │ │ │ │ +4 v 1332 w Fn(ETree)29 b Fk(:)40 b Fj(DRAFT)30 b Fk(June)g(20,)h(2025)p │ │ │ │ │ +2751 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 │ │ │ │ │ @@ -7073,17 +7062,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 1156 4 v 1338 100 a Fn(ETree)29 │ │ │ │ │ -b Fk(:)40 b Fj(DRAFT)121 b Fk(Ma)m(y)32 b(17,)f(2024)p │ │ │ │ │ -2651 100 V 1156 w Fo(21)337 399 y Fl(\210)45 b Fo(The)30 │ │ │ │ │ +TeXDict begin 21 20 bop 91 100 1149 4 v 1331 100 a Fn(ETree)29 │ │ │ │ │ +b Fk(:)40 b Fj(DRAFT)121 b Fk(June)30 b(20,)h(2025)p │ │ │ │ │ +2658 100 V 1149 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 │ │ │ │ │ @@ -7166,24 +7155,24 @@ │ │ │ │ │ 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 1156 │ │ │ │ │ -4 v 1339 w Fn(ETree)29 b Fk(:)40 b Fj(DRAFT)30 b Fk(Ma)m(y)i(17,)f │ │ │ │ │ -(2024)p 2744 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 │ │ │ │ │ +TeXDict begin 22 21 bop 0 100 a Fo(22)p 182 100 1149 │ │ │ │ │ +4 v 1332 w Fn(ETree)29 b Fk(:)40 b Fj(DRAFT)30 b Fk(June)g(20,)h(2025)p │ │ │ │ │ +2751 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 │ │ │ │ │ @@ -7251,17 +7240,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 1156 4 v 1338 100 a Fn(ETree)29 │ │ │ │ │ -b Fk(:)40 b Fj(DRAFT)121 b Fk(Ma)m(y)32 b(17,)f(2024)p │ │ │ │ │ -2651 100 V 1156 w Fo(23)0 453 y(Figure)26 b(1.1:)40 b │ │ │ │ │ +TeXDict begin 23 22 bop 91 100 1149 4 v 1331 100 a Fn(ETree)29 │ │ │ │ │ +b Fk(:)40 b Fj(DRAFT)121 b Fk(June)30 b(20,)h(2025)p │ │ │ │ │ +2658 100 V 1149 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 │ │ │ │ │ @@ -7660,19 +7649,19 @@ │ │ │ │ │ 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 1156 │ │ │ │ │ -4 v 1339 w Fn(ETree)29 b Fk(:)40 b Fj(DRAFT)30 b Fk(Ma)m(y)i(17,)f │ │ │ │ │ -(2024)p 2744 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 │ │ │ │ │ +TeXDict begin 24 23 bop 0 100 a Fo(24)p 182 100 1149 │ │ │ │ │ +4 v 1332 w Fn(ETree)29 b Fk(:)40 b Fj(DRAFT)30 b Fk(June)g(20,)h(2025)p │ │ │ │ │ +2751 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 │ │ │ │ │ @@ -7751,17 +7740,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 1156 4 v 1338 100 a Fn(ETree)29 │ │ │ │ │ -b Fk(:)40 b Fj(DRAFT)121 b Fk(Ma)m(y)32 b(17,)f(2024)p │ │ │ │ │ -2651 100 V 1156 w Fo(25)227 399 y(the)h Fn(flag)e Fo(and)h │ │ │ │ │ +TeXDict begin 25 24 bop 91 100 1149 4 v 1331 100 a Fn(ETree)29 │ │ │ │ │ +b Fk(:)40 b Fj(DRAFT)121 b Fk(June)30 b(20,)h(2025)p │ │ │ │ │ +2658 100 V 1149 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 │ │ │ │ │ @@ -7825,18 +7814,18 @@ │ │ │ │ │ (\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 1156 │ │ │ │ │ -4 v 1339 w Fn(ETree)29 b Fk(:)40 b Fj(DRAFT)30 b Fk(Ma)m(y)i(17,)f │ │ │ │ │ -(2024)p 2744 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 │ │ │ │ │ +TeXDict begin 26 25 bop 0 100 a Fo(26)p 182 100 1149 │ │ │ │ │ +4 v 1332 w Fn(ETree)29 b Fk(:)40 b Fj(DRAFT)30 b Fk(June)g(20,)h(2025)p │ │ │ │ │ +2751 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 │ │ │ │ │ @@ -7905,17 +7894,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 1156 4 v 1338 100 a Fn(ETree)29 │ │ │ │ │ -b Fk(:)40 b Fj(DRAFT)121 b Fk(Ma)m(y)32 b(17,)f(2024)p │ │ │ │ │ -2651 100 V 1156 w Fo(27)337 399 y Fl(\210)45 b Fo(The)30 │ │ │ │ │ +TeXDict begin 27 26 bop 91 100 1149 4 v 1331 100 a Fn(ETree)29 │ │ │ │ │ +b Fk(:)40 b Fj(DRAFT)121 b Fk(June)30 b(20,)h(2025)p │ │ │ │ │ +2658 100 V 1149 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) │ │ │ │ │ @@ -9718,17 +9707,17 @@ │ │ │ │ │ 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 1156 │ │ │ │ │ -4 v 1339 w Fn(ETree)29 b Fk(:)40 b Fj(DRAFT)30 b Fk(Ma)m(y)i(17,)f │ │ │ │ │ -(2024)p 2744 100 V 0 731 a Fo(Figure)c(1.2:)39 b Fa(GRD7x7x7)p │ │ │ │ │ +TeXDict begin 28 27 bop 0 100 a Fo(28)p 182 100 1149 │ │ │ │ │ +4 v 1332 w Fn(ETree)29 b Fk(:)40 b Fj(DRAFT)30 b Fk(June)g(20,)h(2025)p │ │ │ │ │ +2751 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 │ │ │ │ │ @@ -11999,17 +11988,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 1156 4 v 1338 100 a Fn(ETree)29 │ │ │ │ │ -b Fk(:)40 b Fj(DRAFT)121 b Fk(Ma)m(y)32 b(17,)f(2024)p │ │ │ │ │ -2651 100 V 1156 w Fo(29)227 399 y(of)j(this)g(sup)s(erno)s(de)d │ │ │ │ │ +TeXDict begin 29 28 bop 91 100 1149 4 v 1331 100 a Fn(ETree)29 │ │ │ │ │ +b Fk(:)40 b Fj(DRAFT)121 b Fk(June)30 b(20,)h(2025)p │ │ │ │ │ +2658 100 V 1149 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 │ │ │ │ │ @@ -12170,17 +12159,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 1156 4 v 1338 100 a Fn(ETree)29 │ │ │ │ │ -b Fk(:)40 b Fj(DRAFT)121 b Fk(Ma)m(y)32 b(17,)f(2024)p │ │ │ │ │ -2651 100 V 1156 w Fo(31)0 399 y Fn(ETree)p 246 399 29 │ │ │ │ │ +TeXDict begin 31 30 bop 91 100 1149 4 v 1331 100 a Fn(ETree)29 │ │ │ │ │ +b Fk(:)40 b Fj(DRAFT)121 b Fk(June)30 b(20,)h(2025)p │ │ │ │ │ +2658 100 V 1149 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 May 17, 2024 │ │ │ │ │ │ + 2 ETree : DRAFT June 20, 2025 │ │ │ │ │ │ • 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 May 17, 2024 3 │ │ │ │ │ │ + ETree : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 4 ETree : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 5 │ │ │ │ │ │ + ETree : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 6 ETree : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 7 │ │ │ │ │ │ + ETree : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 8 ETree : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 9 │ │ │ │ │ │ + ETree : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 10 ETree : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 11 │ │ │ │ │ │ + ETree : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 12 ETree : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 13 │ │ │ │ │ │ + ETree : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 14 ETree : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 15 │ │ │ │ │ │ + ETree : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 16 ETree : DRAFT June 20, 2025 │ │ │ │ │ │ • 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 May 17, 2024 17 │ │ │ │ │ │ + ETree : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 18 ETree : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 19 │ │ │ │ │ │ + ETree : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 20 ETree : DRAFT June 20, 2025 │ │ │ │ │ │ • 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 May 17, 2024 21 │ │ │ │ │ │ + ETree : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 22 ETree : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 23 │ │ │ │ │ │ + ETree : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 24 ETree : DRAFT June 20, 2025 │ │ │ │ │ │ • 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 May 17, 2024 25 │ │ │ │ │ │ + ETree : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 26 ETree : DRAFT June 20, 2025 │ │ │ │ │ │ • 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 May 17, 2024 27 │ │ │ │ │ │ + ETree : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 28 ETree : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 29 │ │ │ │ │ │ + ETree : DRAFT June 20, 2025 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 May 17, 2024 31 │ │ │ │ │ │ + ETree : DRAFT June 20, 2025 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 │ │ │ │ │ @@ -7,15 +7,15 @@ │ │ │ │ │ %%BoundingBox: 0 0 612 792 │ │ │ │ │ %%DocumentFonts: CMR17 CMBX12 CMR12 CMR8 CMR6 CMR9 CMTT9 │ │ │ │ │ %%DocumentPaperSizes: Letter │ │ │ │ │ %%EndComments │ │ │ │ │ %DVIPSWebPage: (www.radicaleye.com) │ │ │ │ │ %DVIPSCommandLine: dvips main -o Eigen.ps │ │ │ │ │ %DVIPSParameters: dpi=600 │ │ │ │ │ -%DVIPSSource: TeX output 2024.05.17:2218 │ │ │ │ │ +%DVIPSSource: TeX output 2025.06.20:0450 │ │ │ │ │ %%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 │ │ │ │ │ @@ -2005,23 +2005,20 @@ │ │ │ │ │ /UnderlinePosition -100 def │ │ │ │ │ /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 49 /one put │ │ │ │ │ dup 50 /two put │ │ │ │ │ -dup 52 /four put │ │ │ │ │ -dup 55 /seven put │ │ │ │ │ +dup 53 /five put │ │ │ │ │ dup 65 /A put │ │ │ │ │ dup 66 /B put │ │ │ │ │ dup 67 /C put │ │ │ │ │ dup 74 /J put │ │ │ │ │ -dup 77 /M put │ │ │ │ │ dup 80 /P put │ │ │ │ │ dup 87 /W put │ │ │ │ │ dup 97 /a put │ │ │ │ │ dup 99 /c put │ │ │ │ │ dup 101 /e put │ │ │ │ │ dup 102 /f put │ │ │ │ │ dup 103 /g put │ │ │ │ │ @@ -2031,16 +2028,16 @@ │ │ │ │ │ dup 108 /l put │ │ │ │ │ dup 109 /m put │ │ │ │ │ dup 110 /n put │ │ │ │ │ dup 111 /o put │ │ │ │ │ dup 114 /r put │ │ │ │ │ dup 115 /s put │ │ │ │ │ dup 116 /t put │ │ │ │ │ +dup 117 /u put │ │ │ │ │ dup 118 /v put │ │ │ │ │ -dup 121 /y put │ │ │ │ │ readonly def │ │ │ │ │ currentdict end │ │ │ │ │ currentfile eexec │ │ │ │ │ D9D66F633B846AB284BCF8B0411B772DE5CE3DD325E55798292D7BD972BD75FA │ │ │ │ │ 0E079529AF9C82DF72F64195C9C210DCE34528F540DA1FFD7BEBB9B40787BA93 │ │ │ │ │ 51BBFB7CFC5F9152D1E5BB0AD8D016C6CFA4EB41B3C51D091C2D5440E67CFD71 │ │ │ │ │ 7C56816B03B901BF4A25A07175380E50A213F877C44778B3C5AADBCC86D6E551 │ │ │ │ │ @@ -2214,188 +2211,170 @@ │ │ │ │ │ 82032FBD2FCB6E403D34B85ED4053A8CB619BDD4DE001F4C3007B1F317579651 │ │ │ │ │ E6D6662189CC2D95AB85D7473F65C5D7B4AC63B0FE928F3400035D5A9D443D0D │ │ │ │ │ F3532B99F3AC26CB25EA3CD64C341159061E02EFBC7C033C05CD919BBD827A6A │ │ │ │ │ BFCF3BD739E32E7FE909AEE068D50FAC33605FFF98C7D0115FB860178FD03DB9 │ │ │ │ │ 7985B78E0AC21F2EA065FA841F5928FB85163B2E2D8F850DC7EE313912C45C28 │ │ │ │ │ 2783F6762C67882EFEDDC7E7567F91C16B16FD8D5A1ABF35B5586307701B91AD │ │ │ │ │ 54984598F2AD46FEE3D68A2731BEAA754C8E730FE0E84952EF77930E4118F8D7 │ │ │ │ │ -2F3AD7547ECD7EB31108291A22BBC656F4D968DF891E4F87EF8FFE711A48FFD9 │ │ │ │ │ -94762E9918C42251D75772AC97BC15A4FF63D911D96AADA1CFAACE8D7001935C │ │ │ │ │ -9D7A0E6B35E1522780C2629D74057738FCE1BD41CD81D97BFD99D19FE03B2EFF │ │ │ │ │ -7B80B18DA5538D06A810DD315F31DE1331EDB82DAC760E6D8A855FCA3C8DD9E3 │ │ │ │ │ -61164D1386FCA2A0E7735AD69D7D9C6335F02064419B2296ADA17DC51A1E2195 │ │ │ │ │ -45FA3A158E075213ACD6607B07385F0D9F5F3C5C385624B43B10016D497FA569 │ │ │ │ │ -103C0A7CC701BF1558C587B15A8094D8E4524D74DC263BE9C5D1C96970A7324F │ │ │ │ │ -5514ED0576D79D5A7C8CC2859C832B0C5869166DA1DB8CAC589AC9EB48379CBB │ │ │ │ │ -33B840FDDADDDA5FFFC54678E901A33854A703C01C16945C99655BF1BEA74EDA │ │ │ │ │ -723B5FC176D9693ACA831C563CDB35C96C69575A510E33D5BB62701CDD2A759E │ │ │ │ │ -79C045541F511340C52E888907801E3548CEC3D2BC22BA40337B64A862929ECD │ │ │ │ │ -6D7C3F92B5C9AC4427AA6986DDB6A4A792F5FB6C969F50C5068CB2A5C9205191 │ │ │ │ │ -C19B22A4D9627E0304444D963FE2F3C6FE86818FF3A6B50130BCE2DF5DAE000D │ │ │ │ │ -658D411135E9DFB829BCF033FF4ABF1A3F3E6579537DB4D17EA4BF7F2F6ACA4D │ │ │ │ │ -6FA0858A09BDD229CF49A29030D280273CEACB3E72945F424D8AAF50E53187D0 │ │ │ │ │ -61786DA0263FE776D86CC33DF81D8C0325343665F9E6096EA072CD7F53C9FDA8 │ │ │ │ │ -74C647B762ABD1B70F4315247C13EAA98B41F80E9A3E62DC60C8FA85254E5239 │ │ │ │ │ -6F9D3EB9C81F9A4EB912388D4F56D56ECB4179475564C8665CDE38A211E518A0 │ │ │ │ │ -96C3577DF26ECCE018A8C4A547CA4D04E6CFF0CD0F5377FF9D64E584E0A506AB │ │ │ │ │ -C5E8D801F041938BF9F11DB1F8496A26D416A8CA3F96E6E43F149E720F43F1FB │ │ │ │ │ -041E107C8F4752AD70F2FDB90292F314F46D175AB7C9E67CB61C820B36431613 │ │ │ │ │ -D24E877E74EEBD37AF9B2A6D5A0B970F1619FDD5FA8EEA9C6040251136A79F29 │ │ │ │ │ -9900E9D3E27DE70055DED223484D7E8701F0B0AACE6B7C9A56C81A8FD69BE0C7 │ │ │ │ │ -1321229E636B6FC5239806C6A6ADF975BB49922CB8BD33673C5BA58E2BC89BAE │ │ │ │ │ -F112E6D7F072BA8276F0FA9E849DDAC1850485863FF731D8B6A671D7BFF94689 │ │ │ │ │ -48CA38DC9ED526469F0F138B1466AEF50AE0C012F09410C0182EBA14EDA6F88A │ │ │ │ │ -12B41CB89998D82D12D6EE917887E66A0D104BD57605645586B3CB02E82E96A5 │ │ │ │ │ -C68BCFE7B8FB2A1A974AFDAD1A5ABCE8FA322195123B2B756E1C73327A89A40E │ │ │ │ │ -92195C4BC057039D69B23F2D72278379E88BEC6023E21BCDAC6B09BCF3A2C84E │ │ │ │ │ -880B4D0514D8177E0B0303E4168A26F4F546B4C147EC46BE1781BB18036D2D41 │ │ │ │ │ -86167DB95D0E91104F342037ADAC83EB146F08159CDEBA1253A6F4B5D8867F75 │ │ │ │ │ -82C1F357F3F916633F96FCFA5841C4315B6D39A7ED995426C51D691CA70A100E │ │ │ │ │ -4C192AE7D626693EC1D685DBBD74BD1EAFC9D037C4EE8CCEDA8D87F504F8FBDE │ │ │ │ │ -9F9BBD3E102F7D4D45D41C7170FA39FF1AAD80AAB0896548E7FC42ACAF8B8B59 │ │ │ │ │ -181507AC944DF27CFCAF8E8CAD8E158605E1DC0EB6A053D19EB868CBCD651678 │ │ │ │ │ -9C9D8B68BA07BA9DE05043975CE9D45CE6D060EB71F1C1AC6F958487E7C23C20 │ │ │ │ │ -C8FA50CD4A1D90E69CA569BA49D747961619780760CA29B23D7C59B2AC56D44A │ │ │ │ │ -7BABD02E07229779B6620473A84B51C72749DDAC4CAE8447FBD2FF0A1AABE41E │ │ │ │ │ -73BE38353580C97C4290101C70A7A68A3FC6BAD1C687542224F6D0618B20A0D5 │ │ │ │ │ -107766CB76C35F94C0375189D1FCBDF95C0EF63F492B83D349E196BC653F82AB │ │ │ │ │ -5CCA7A454E7307F88377DC1BAC1D094433D1B6FA7A9D219DB131D8D97ED81012 │ │ │ │ │ -101E95FB9C4B80F96D088FA02E4BDDDE98CFC4F7C2CAEC8CE29A1738998170C1 │ │ │ │ │ -9A296F3EE4BAD358C0B7088104D4686AA9C63CF636093D54E2217E9151990367 │ │ │ │ │ -2723D577F4B6ED6F525E5D66EDF8A007C8C52CF37D5867100F28F0AC60EBF743 │ │ │ │ │ -970AF1E99363C29FCDC3BDB5F3270C4934C83C92FCC3747E33A7F51006CA1C8B │ │ │ │ │ -1D0687ECBC3615193DF41AAB85F4B458C945D897304EEA1A8AFC5AD159C52B5F │ │ │ │ │ -4E10F3BB33352AB106B6108FB329A34BDA0E95EC82DBEFB230BCB66AE8E7489F │ │ │ │ │ -F57A364389D26BECEB888481C4F7CA1AE570FC1EB4981A247F252BCC43D90496 │ │ │ │ │ -C0DDC1AC4A2265D1B33F0704BD2A39D369A59A017EF160A27B9CB50F62FC7C2F │ │ │ │ │ -89EB4400D49E1F418CB1961E24F7CAE6906AB884EF917C8BEAEF5938AD90DE72 │ │ │ │ │ -B654B116198FD1E07FFE889272F1E91C885ACC588D1411FDB584262D8119E199 │ │ │ │ │ -8013691B92DFE79C8137EE12621AD09F15D49CB864687292C914050F92E12EAB │ │ │ │ │ -96465BF0999893836C3C2053B28D77BFEF2903CD92674BF920CBCB9D3328BBE0 │ │ │ │ │ -54AEA9086AEE2CD8577E04634BC39D2F437FCDBD187DB302C02F166E1837D653 │ │ │ │ │ -103A1B45A761201A5C68F20B5D7F4B68CB69DC73AA37D78742D86960E00E5986 │ │ │ │ │ -34C6D78600954CBEF2F71DEEFFA210D546B487D80C86461CDF084B59B578D60A │ │ │ │ │ -3EB6A66A4F0BADA1927DCE5C2D83A770A3B8F0C26A975E0CA75ED05CEB5D02E7 │ │ │ │ │ -58CC2C0909D278396E4142DCE7AC734160862F687BDC50216EAEAEE6DFC91244 │ │ │ │ │ -C564F9BA333944FF4830D8BF697C2B60E88D182CDC4A5CF17C9B7F02246BAD87 │ │ │ │ │ -B78B84FBC765D61B29E45AA33B7FAF4486B2BB6747C78BB2483823B4D4CA05FD │ │ │ │ │ -F9687963FADA0E61A33584FE5E2CC04A1CFEB8D61526F1603F206A95FB8E76CB │ │ │ │ │ -67D551A1BC9A05CBF3717B30B6F04B5C0A036D24B126191B5D9A4C81A111DA1E │ │ │ │ │ -88CED55138EAED0E79D8E6F4FE530613A3EB6836E9132BDE1D152C3C90A15AC0 │ │ │ │ │ -8CB19F954F13682F32F573A98B5824435AC05E36E629BB5A68BD9E1AA01BC071 │ │ │ │ │ -EE1C509640754681FF623AC7A5F3EFB3C892DD40D0FCC89725661A702DC23FF7 │ │ │ │ │ -3B53B7A071665613CE1C303B6E0829F640E2EE6824F184342C5E64B73A61B457 │ │ │ │ │ -9C7B80804DC3E7761AC0B309324400C911F662224CDA692D0560B93214CF414F │ │ │ │ │ -2FD565AC141CE8800D6B0FB1DF559AEF879BAF1973774CD0ADD8EBE4F7C18718 │ │ │ │ │ -9353F8FD7A384930A9284C8A4604323FC350E1EDB347D9F06B0BA1D27993E403 │ │ │ │ │ -55B5BE934DD75BBEB85BDB33EB95EBCD09186562B41F98486C575ECBBD3C5D20 │ │ │ │ │ -77FC2D328624F4A6C7292B673B73A3491B705F67314C5F25B6F2E95B8DF74008 │ │ │ │ │ -A1111C5DAAACEDA36596FDAA444A0BEA76477E93FB8940F72ED1198FF203013B │ │ │ │ │ -E4D1B96DE512B3E582A5680D141A513A807E450D80CD841E24609060C3636343 │ │ │ │ │ -38992B68A0DE5C4487896F21189C768CE6622D26BC4324474E8BF7A6B06639FB │ │ │ │ │ -AF132855BA7415178BFEE68B08E6A11B3AA033890D93F6AC28502B654C31039D │ │ │ │ │ -CC7047AFAA7D3386F95BF6D9FCEC9B456E6492830FAB24A57558CE87B58C643B │ │ │ │ │ -499CE1F92818859E81B2E9E3D43B311F51D4F9640CFE8E1B4C9F9A72809D3D28 │ │ │ │ │ -3D2072E685AEE47CC2E55B0B7142404C304AB6A495CB19F0A773CF7F2581DF37 │ │ │ │ │ -83949026C134780288CB0CEC5804D8E59AC075DAB63AECDEA93540E337526572 │ │ │ │ │ -6D96477B13450C6A1164486651FAC698411C206A9D32F5C95966F90985BF6D07 │ │ │ │ │ -1B098E8642914F29527629DCEACC6CA1FDAD98565C8D767D2EE6CFEF2DD5C667 │ │ │ │ │ -28A5BCA4CAE891BCB0C8F4BA813728A311F78152769F21AF47BC8080E17E1990 │ │ │ │ │ -5CFF13BB00DF4283E527D3A692CD6340915A54267179FCEC8961BFF7D7F1F471 │ │ │ │ │ -66A4D9EE47CB9D6CF064FEB356F5D19E8144E9C66D082A7C3BD29248DE770049 │ │ │ │ │ -E9EB5642999E4D1F915D1EF1B3F83FBABBC20B5D29F11036B5B8FE1370B084B5 │ │ │ │ │ -36A4C0A4BEFDBEAF6B7E248009FA4D29DD84240BD397BF931F23DCB03DB59DD8 │ │ │ │ │ -0073B5FDBA5F0CA65F5F05DC012CA42CFFB6489C2A71EDDDAB30C79ADF5960EB │ │ │ │ │ -CE2357C4CDC45EC515C551580BA2F2300800A3DEB299BFA7F3FE1B337D8B23DD │ │ │ │ │ -BD21D363B9424D45B683C3618607A30B9F95E8F8AC12B17C61B18A62EBB2144E │ │ │ │ │ -269AB0D0EB7EC9BB509F070E3E8832BAA635ED3FCFE33094127ADEA83EF09DF3 │ │ │ │ │ -ED17A41F8D6AEDB5364C72D3AE69A75C9A4A315638FF75DE395DBFFD424757CD │ │ │ │ │ -DF9D1DA6EB798731B45898636F339C2DC942F3EE92247B4F666A86FB7A33AB26 │ │ │ │ │ -6DA97D37F2A001A2F3B00632F166647309682A63AFF61F4D75C26B52FA342015 │ │ │ │ │ -E281EF34EB08A4016A71CE06410B046B35ED2727EA8C7D95F19D874080AABBE7 │ │ │ │ │ -CDE9C1E1C3C0E6B30C1423D00A3E47347EB0EB2B86688F0B9337BC845D279267 │ │ │ │ │ -4A2C39433748AF89E86D9F4595DB0F91BF80FB87DED876B6F5D9839F3B297A3E │ │ │ │ │ -6CEA4233D9D4CC48627F2304422611C590A122B20EF2C38CD141AEFF0DE35783 │ │ │ │ │ -FD41C96BE154D4FF350DA904CB18FD9AFBDAA1A99219E6B7D4F1FCDF48037499 │ │ │ │ │ -793A4F5677CF92FEA77C09E6AD87BCC3A84D93B3771C5491E223574B4FAF8162 │ │ │ │ │ -027613B56DEB38416E1BD6DB0B95739538445A84279F8C057FDF38F2A5EEFEB2 │ │ │ │ │ -FB410E28D510B85EDDBB2009CBA1282C8C6D5A150F87AA4DEFCF8273D9348549 │ │ │ │ │ -4D9BEC31500C4CB3B944DA2F2B2622655690A38D6750C80AA5B64A5657883A28 │ │ │ │ │ -2D6ADDA1B1B706C1C48DA9D2DD79FADCDB2836A89BD31D3DB90F687614FECDCA │ │ │ │ │ -9D73B82B721120EC7D3BAC43167B11A1024B68E4A78E225C6A380AADCD885288 │ │ │ │ │ -7D78138490DF807D9BF0D045C4B12A424A17DD0E4E133BD862D107B232CB71E8 │ │ │ │ │ -A6DFF8B239874FFE20D5C13CD75ABFC18CB9A7A8C0E7F3293EF8A00975B7A828 │ │ │ │ │ -5A17BDF15AAF4C2A22EA811F2CEA53B16DCFD5F2FDAFF43AD0E26B1DE42A2660 │ │ │ │ │ -A0D5B1782091958AAC6A6390034BB7C868990BC857C1AFCF339BFDAF1503B733 │ │ │ │ │ -690B0AEFA0D8E365D66DA2A4B6A2DC791247A5DF6E0967B5F08488AC2300DD4D │ │ │ │ │ -120BF2E633AC8A94AA7C5C5A792CAB89DC298EF425EFC953209122BF82BD349F │ │ │ │ │ -3164669415A897004EE6D8732ACCD58767E0C0B14A0C323292DC14EBBFCD9067 │ │ │ │ │ -191EC41EDA0BCEC2205C4450736B64E928EF5ED3D17A3729154C4F0A74529559 │ │ │ │ │ -0AE04863BC4ACE596CA6E0320B514A4DAED33F8DE452E6F0D8E6001134D213AF │ │ │ │ │ -65A5A895DBEA7ACA80D48AC22B8542A34FD6BBB62F88A590AC88E23175DE0A69 │ │ │ │ │ -34EE2B7202698B0865C685043129B7C18688F151B3B439C67343598A92E199B4 │ │ │ │ │ -B6CDFD3CA223D6EFB10B2EBC4C43BD4DC858A1C6FB83E2A476C24C89EB186A32 │ │ │ │ │ -F602D87B4B776EC0BE4C131AEDEA943803C0ED45017EF1BA9E086EEC55FCE401 │ │ │ │ │ -E2391094A9D8D043A65C1FFE32A8080D7C1FA2483F866571BEB5B2EA1B3CD207 │ │ │ │ │ -11FE99477ADC3F692730BF7F9D17C2CD24E9E49555CB454B15722113EB12988C │ │ │ │ │ -ECFA7356CFE7441A6CB4535792FDD7586E2FA4EE34AB36B4CEBA5DB7043BC7E2 │ │ │ │ │ -D1A12A5726D2B252161FF273A7DA6B36838DEA76245FBEB7BC6862697F946B34 │ │ │ │ │ -A0BE7E59C73FE17956337935D2A850E237004932B23254ABF1F23BDD5D0BBA72 │ │ │ │ │ -67E4A9F3EE200A96F4D689E1C56ACB7763987C859A8EDC8D959494B71EC0896B │ │ │ │ │ -ECEDA4BEF6954B3D9B21D22C10F9E6E97179D86628177E3B4A7C0FF274F70A71 │ │ │ │ │ -C3F1C35104E2E73EEE0F32F12F5BD2458E9430C3439CAAC239E7DB11909D84E5 │ │ │ │ │ -A59D453884E00F67763D0ACA725E2206D5B6368643599EDABDE71261BB7A2494 │ │ │ │ │ -72E88E0ABD039B9701EE09F4E058F553943C0D1BB2FED0961A8244E5D2683F59 │ │ │ │ │ -3B5310BF5590F6D145A7FE205E8D5D3CC26219C26C23B310B69A26E431E90223 │ │ │ │ │ -3B349191DED9E524F92A3D6F82445118F159CCF126AC141B1C506ED6845B93DD │ │ │ │ │ -F5DE9F2BC863B3E6B0B0F998C34153685C2A07711DD7B6056CB148C480C3EA49 │ │ │ │ │ -AD6D0E7A612B268758216E59DC348B815220077EB3CBAAF26A0C31458FAC680B │ │ │ │ │ -66DBFDA1CF32A9E980DCD955CF2F3A32A4EC4CAFC94095220D94CA412D909F82 │ │ │ │ │ -2C7593DF464513A7E77983A388FFA22342B19357F6B887AA4B182C0F75494244 │ │ │ │ │ -B23E1B8DF917C481888D04FA472084ED9031D981C4D93CBEC924ED1E0702F957 │ │ │ │ │ -182D73B4935FBEA4979115C12A284C0398691C9F02376497221EFCA6A2FF5461 │ │ │ │ │ -E4C3AFF7238940F65D8B4D14F0856BFC5C8FE0FB4A0C239599C07E5C46965546 │ │ │ │ │ -68D855ABB9F3949D3B4407C49C4A6F93FACD0CEE482302AD7FF3C2E4AECFA359 │ │ │ │ │ -BB173C3510BA114E75080FCE240A6EBC39751CDDA60CD27B065CB5D698353161 │ │ │ │ │ -B2D10DF27D5E53DCC1DD5AFA200771CD98A5043112B3586D402159D7130B7B9B │ │ │ │ │ -FBCCF2CDE6332E76B7F5134AA0A95E3C6A0461D1882EB179EE80BED950567A16 │ │ │ │ │ -A4ABEF6CB844FA68C33EDFE2CFBC1E8CEEED93770F5E954B7AD96A2E5FF69B91 │ │ │ │ │ -F7786C51EE59D72F2C001C9E8FEC974CAC8B7E3C004371FD2FB190E679AAC889 │ │ │ │ │ -99B19367801BA532E169C5AD3D32D228FE98D4FF553FD782163E5DE5826807B4 │ │ │ │ │ -51F658EFA514978A595DD1E3AC674D3874EC0C35358EA1670B81703CD6CBB533 │ │ │ │ │ -DE14AC7B8B7B590F5CC337AA3138AB4B97A66ABC2902EDC576D43C39A8903B14 │ │ │ │ │ -CA49399E188A9306E440878259744BFD7E7C9DBC3AD86C87CED12CAF4C233966 │ │ │ │ │ -B0E84B4CB180AF98293EA3D63751114D2DCAE115D20A4152BF28811EDE92FB3E │ │ │ │ │ -C08BA385B17ECD04E71DF41B28C04577EBE9C0FFEEBEF15E46BF64F300A1ECED │ │ │ │ │ -9E2DF0924594473F74A1FDD8457DA06BAAF91F57964027A8783C22E6F43B13E6 │ │ │ │ │ -C6EDF21E46A2D835FA09785C22F71A1D932DE3678CB0742253BBA20AA0D37CA7 │ │ │ │ │ -C2369606F2EE32D4D92B4A5A768E71AF51D3CFE321BA9381ABAE0FA839C8510B │ │ │ │ │ -C709A2C7F1799567D3FB8766685009CFA449C35FE8B05021F70695C0232E2C26 │ │ │ │ │ -66A51E55F6366F72E7057FE80D004D07C6097CB27EAC58528000A698567560C8 │ │ │ │ │ -B44C8741C99C170828DDF010108E27221AFE350331379CBF773B972766CFB8FA │ │ │ │ │ -1EBEDC88C70809FE8818D5BEA092B447C223F867F420D5D1C8F387321B083C3B │ │ │ │ │ -61E4FE0D6862BCDE1DE0F39063723D91ECA4940306443C4FF02DDF3DC73013DD │ │ │ │ │ -5B35BD195D28865E2066BC55EE86AE90BC17701B533789A77B21A4B5B8C89431 │ │ │ │ │ -9F979B6DABA517750B61BF555F90B8C855BFDA2F7B76A8C4D1BEA11FBB67E7C3 │ │ │ │ │ -CAADCE6B73DA2AFD4D92329F0EB929174EF6BB14FA485A9DA271BEF28E088856 │ │ │ │ │ -B2FA37C70D8C8D76B02A3789A2B83821F2302537985C0C0A4E5A0EB9D35A0768 │ │ │ │ │ -60781707B01F49FEACC1D86EEB01C0FC1C85AB4D7D0526A0A6DAE6ADDF9E27C1 │ │ │ │ │ -22F83C2F412382B82F3147E39CEE5124031CCC05CA7004D1EF49299EA8F3E9DE │ │ │ │ │ -6D69F128060C9F3E9CE85F070A464E27DC1D2DF64D7DF911C9AFE2C596393850 │ │ │ │ │ -F5F7063127FCDE7B6FF8E35FA045E8A194A7B4A49AE128C756F25FA52567DB11 │ │ │ │ │ -A1CE431EA74414B57118731B8A62E8BBA13E18E8D8F1B8590BF86864DED52F69 │ │ │ │ │ -6871E9922FF672EB9DEFAEFAE067B620971FC7FBEA1DA9DAAAF86E8570428A8F │ │ │ │ │ -58A1009993EE45349CC91B1F319959597F9DE648A2F3AE5EF21631BB7B76B494 │ │ │ │ │ -6B7C33A3CA4B424AECACDC7396F239A11B45EEFC05D438D794323D37E833152B │ │ │ │ │ -D306E0D28E895BBD929382308829C7B718EF48D202C9386CEBFDB4E8AC2E3765 │ │ │ │ │ -D44E31995B7894A5C10E801E6A7CC03F10E6FE6130A48C1FBB4C673F1D089450 │ │ │ │ │ -CB4349B631174EA2E4466DA5E54C8E701D52497C4903B26892F334A36B44B148 │ │ │ │ │ -47FAF557360C44781B44414B158D339DAF5852C88B0CFDD23D96B0BB19742AEA │ │ │ │ │ -5F08BDC8E2FF20C8B4DB8F1E3497232264978A9442A7013907D5F71A64672735 │ │ │ │ │ -96DC │ │ │ │ │ +2F3AD75525E301D173E869C672552C3824E8BDFD208D74EB3389931FE4A65013 │ │ │ │ │ +44B963C2233052C5B2B4DBF324B78ED455310BDC5462CD3A7499638173A4543C │ │ │ │ │ +6D4EFF6B28094DEA99C0C72A83C0BF0F60B473AC77FB4BABD830033E73781FA4 │ │ │ │ │ +EA6F715812349600C93793913F8D5AC338F961CC3181E4D83F0FF93105094E9D │ │ │ │ │ +3DC8C5EE5B05D0960B5093EF36859B8D6DBFE4D07327EDACA18BAAE80C1DE33D │ │ │ │ │ +6A472DCD303B5B19EDB3C84DE6CB429953C8601159E885E8C17CFDEFD230B9AD │ │ │ │ │ +9434ADD33D46D7B130E01A4F32C39CB42FBF15E58E736FD333D872E1745741FE │ │ │ │ │ +A32F76CFF60E1E8388781E1C45DFB395BED3118539DEA52C3248BE07F4BED3FA │ │ │ │ │ +C4639FBFAD8B8455BEDD73697CF94456B87E5874E4728BE10D734588BA1AC259 │ │ │ │ │ +5724246C61245B6D770D43A3EF4C5E6D5BFC44AEFD997B99CDF04F1D5143952B │ │ │ │ │ +1868C8B0C3250E81B78AE365EFB64149E171160475E47B6EC739F00A797CC63B │ │ │ │ │ +883EE801DC22333C13B44D720DE4229F83E1CE24D7E86C882162BCCD6CA0B1AB │ │ │ │ │ +351C6E8AB001C926C768A9016B06EE3F65E1D0D9AADDFC92BDCB1DDD9F6C648F │ │ │ │ │ +38D5B8772B1B7E40DBAE2E0066D01B2C12051723409C7E920752E2F3568DA3EF │ │ │ │ │ +1FEC48A5AB655F5949C82E22A99BDD724D11DB2475531A67FE7FCDB9B6D54476 │ │ │ │ │ +FF31461EF6DB1198E70E7F688E65D76F1BAF092A322EA1CB6D677503A8CF0BC0 │ │ │ │ │ +D0EC8D4AA53B8AF050A8F25D795F66316DB6A19B648AEFF2B92D8C073C5849B9 │ │ │ │ │ +AE22B2C8A2E1C24B16B422B584D07392A039E02FD022B105D45B98BA46CABB73 │ │ │ │ │ +531B7BFA8F8CE45DFE419969BE8380CD2DB29E21B15F4827F604BAD61FAB0E9B │ │ │ │ │ +EC3BF59D02175921D4633D84815C126E3E534AA898DD069DABFCE079C9F18505 │ │ │ │ │ +C2451298AAC3508459B649B06EDB8FCAF59F9D3C82B88BEB4507CB9E9DCC9CDA │ │ │ │ │ +869B3B744C6E655428553D70B02DA2F498276D5B6734E5E982E3508F5C339440 │ │ │ │ │ +EA4F1BFF6E1BD12B1DE3E497B1C7B342988D1F721F65930E13B89476E943797A │ │ │ │ │ +A657DD993C2DF8307BFA0E6749E4CCEA15D796B66FE200E9E1C6950A29CA2376 │ │ │ │ │ +37EB10B32D5FDF8FE7C2125C33E9B9F29DB71089FAE7DA39205C9300D6FFBAE3 │ │ │ │ │ +F2A4854C765EC2027E57B6E1DF597A9671FCD58459A25B5BB32625E5E4B96394 │ │ │ │ │ +ED3F7443473302699705DEF1EB32C3439C0E318286785F74B517AF39DE6DAED6 │ │ │ │ │ +8146BEEB3EB049DA963DB95E85CE423C76429B9C7EEE088B68C39996FA200494 │ │ │ │ │ +10C6388187E59CDF6ED7F482F6B82F9A09E3ED0BD0275785B7D234E369444B4A │ │ │ │ │ +132484404B975CDF4A70D951126D1B13F8298FF0603AE7FD1AF5896C36396F52 │ │ │ │ │ +3C2F8066DBF2204C0837FE176FCF68391A53F712E8684035169457F036045C43 │ │ │ │ │ +424C5E90110C860F89A5E9FD686D6A6C962CFA050C080AB36C46DF6EB196C115 │ │ │ │ │ +0E125B6392EDE8340464D1128AFF2BEA382BBF715A0D6C1C09F2AD1AD2E91846 │ │ │ │ │ +D59CBA7207E6B92E0D8A7DFACE5A9E2701F157491CF050A06010748D6D0F5D04 │ │ │ │ │ +6040F49C8AC06CAD1DFD027542D01B2186FC2C94D2D212C9241E54A4DAD7ACC4 │ │ │ │ │ +BB799CAB7A7F60C723E27D05F7390BB604C982CB89609BDA39E01F76FCA69D02 │ │ │ │ │ +2DDF1D15BA031355A3FDB9C25B5D015CA1BEFAEA5C3CB2CA62A2CC1F5B4A53BC │ │ │ │ │ +BBD60755E78C5648922E4272836F7EFB4DEE536F3EB2F23ED66D4DECB8202F22 │ │ │ │ │ +3A9606B17E701873BB427A8A99526B044FAB5B427A9943EBDC1C865A739644AB │ │ │ │ │ +E6FA9D7E45E425BB2C5CB73861FC1DCD204E5865DF33E8BB43648FC670E8EFDB │ │ │ │ │ +B82F451737D73653AD46905161831DAB6D2954FB3CDFCB13FFD301FBF5D78F9B │ │ │ │ │ +5524A24E4B35B32E974C17DE2295BFD314EA180AD512A02119257A4D56F8E458 │ │ │ │ │ +C5C0F5DA378CA90CE6B60C041D6D4897F2FB7315EA58BDC98332A5E7A274296D │ │ │ │ │ +CB8F0F8243205A2DA85A93E23629D1F3FBCFFEEFD63C00F64F5A9A008B9CFE8C │ │ │ │ │ +ACB70F18324703A6FF20C30FC0A0B34038FC74BF93CE8A279C4FDA5B1652960B │ │ │ │ │ +679FF3B4325891C8281ABBD04175C8FD2CAD9CF809D707F0ED932DA72DB95475 │ │ │ │ │ +0D7F5FDC3065AAFCBB227AF5F316459FD4C64140354D336FBCE17CD4BEA1262B │ │ │ │ │ +3187B1BE5EC4409722BD0EA0AEE1C117EA3EEEE6C978A2B3F7538676132D8B13 │ │ │ │ │ +EC4963AE873CF3DA6DE2C02A9DB6BE76DF527DC8B0EE98121F9E5707EB8BEDFF │ │ │ │ │ +912A19E67BDC42AEB7AFBAFEEF0F20D44D54BA3A8E5CC1E66696C7FD371115B8 │ │ │ │ │ +9D9A392272AAF223FAAFEACD59DF46B08C83610B3126FA6E8EA30F511D1D6968 │ │ │ │ │ +060D26AC43651A12A33526E91D870E4C9C7545CBF1B331380DA0FC7C504D90E1 │ │ │ │ │ +759B50C510966364D2271948313F1953C9F5F1DE9D88E290427C73DE3BECE6D0 │ │ │ │ │ +358D6D147ACD5D211FAB20BB0FD4188F38954806DB123FB7ED3ADF062C6812FD │ │ │ │ │ +5E5AEAD0BD05674365AC92F5DCC6D6B23B26E05DDD1CF6CB62D401C9E3F631FF │ │ │ │ │ +BC78124A699EA691612A4B537661420E9A36F1966B721FC924777BD39E012D4B │ │ │ │ │ +E5C664DE91650ACC35A0529FE95135A35FFC52E985C40EDFB511B1878AC2AC15 │ │ │ │ │ +FA1770D509C263E3011779EA4E48F0B0EE5078974B85036F80C4F45A9D081C8D │ │ │ │ │ +C34128F950EE5E0467F19D4B1397598F4B2DBC2B1092E83CCBEB0638121DCFF9 │ │ │ │ │ +0F7B8F3F97A622183C9B95EE428321D8470B3DA1CFF3651C0B9E2A90FF1FE321 │ │ │ │ │ +9DB880E3298791453364C3E4B747C433EC6342975F4BBCD7D7E47E2054C0BA2A │ │ │ │ │ +A02CE9A1F28E11CF0CB139FAB85024E2AA85D95FA0F62981B2EC02D3E96727DD │ │ │ │ │ +DEFE474A00486BCE3627E1BD20766DE62E2C6ECD37DDAC21C503DB2EB7D2C9D0 │ │ │ │ │ +8AE1E10DDA4481D337053CCEEE0D5214D4C68AC46FEFD11D0D3D9A64BD280EA8 │ │ │ │ │ +4B289FEEA4E2771F5F778A2781C11F0E6BBA4DAD56D71C29602EB85444BD6666 │ │ │ │ │ +B0158E15741460C064D69266EEC2D0D22D401E426B0C52408EBAC7DDD1D5CCBE │ │ │ │ │ +28DB6659F2FD4018F263B9D9E907F1B1EE1DC21B82725168A4EA1C392CE447A4 │ │ │ │ │ +4EB722DCC0777552B57B9B79C59B7695B16585AB707B13CAFBBFC858A1326D64 │ │ │ │ │ +CE49B8F8129D468F743319F6A3C90155147F124BFA929A1CAF944A708ED7F83A │ │ │ │ │ +F363D4B6F71848BE5F2753D0F3CDEB8E1ED3C09079BFA397C8B3079EABB00588 │ │ │ │ │ +C1B7DD5CC0239BA70C46FD8544DF3DA72DE6C083E4FD55B7156DAC660412BA15 │ │ │ │ │ +326742B719CE034F93C3BA0F55D099358034ADEF356DEDB2B52C35754E32BC03 │ │ │ │ │ +EE47F5E0A430756DA4EBDB1892AF53A44D6F9A2F620C206F10F3F2DC018CF917 │ │ │ │ │ +474D5F839D3BE5C66D66F34BE190800E321A8B1F00DDD98E4E9D727E31977CDA │ │ │ │ │ +7B3AABD0F1F067D86F6CB3A2A14CEF2BD73401DB16FE32BAF67457267CCA1355 │ │ │ │ │ +093DCE25990007DB32DCFEE0AFA0004ADC7B7B55C308C0C288FD2689A4650B3B │ │ │ │ │ +A091898DFFE0447624DCDF5D6F50F5CDAF966E22F7779C911615E50B80C939ED │ │ │ │ │ +3E67485CC847B5EB89B0E0AE3B5B6CF4F855A192F126B7E97918BACD976C4F64 │ │ │ │ │ +E66A93F916A94DF8D5DE77F837E9B11F6B8EF542EF6C8523638A856C8E8783C5 │ │ │ │ │ +50D13C430BE59CDDF5A4C92754A00B3E8AD35E7534739BBA17FA0486BDB481A8 │ │ │ │ │ +18AF562D49C4DC7BCCCD9A935DD72DBD7D2DC55F505857C4B73C627834079050 │ │ │ │ │ +CA334CF2D75D7D1B32AA8DFD04A6ACC35EAA1DB0D394CD3D4B53CEA7672756FE │ │ │ │ │ +033FE64CCB1BA20F144A9B4C138284C0EE501FC7C4E2CF40839B6ED46E346354 │ │ │ │ │ +D5BBAABAA8B09F21976082A652ED8120CCCD7B7519634856DDFBFFCD886D3D18 │ │ │ │ │ +BE5AEC6CECD3031FDBE1F4AB7A80819FA2646BED8080D4E2F2B639863BA2B825 │ │ │ │ │ +63560FF8567667B93DD6A72CE4B7D2522D4BE2176B40C19506E97EA8EA7E00CF │ │ │ │ │ +D43DDD4972E3C73C399CAE7BAA01EF2F54AE9E744A09038B63A8B451A71D2B7D │ │ │ │ │ +2ACBC0B8E8872FF58DFE18E5D23C81947B0C83836E1821BED1FAA857894E18AD │ │ │ │ │ +6ABE8E0042600A495A7EE7B9029BD5C2926818CD6132212C6BE96292E7A127F4 │ │ │ │ │ +7E3A4B683319FB4D114EF3E7CCBE25D90685CF19E18383E3EC3593AD33E3A823 │ │ │ │ │ +2892D6D29BEE20E0F0A79A5593242247BC2A5FCD04FC642B830F232EB98B2CBA │ │ │ │ │ +539C46D84EAD6FBAE5B2AB98D08C95132383C7F8B57EB65983E7D2149A6BC6C9 │ │ │ │ │ +D64E6748CDAB98A225D4A30A9F32663BEC2A29CF0CCC460D10A74F5AB8A70A22 │ │ │ │ │ +AEE6D25FD9D034FB5AFEF994410EAAE073310048CA573C1CBF3BA9C76AF6568F │ │ │ │ │ +49C30A3097B4A7BAB3AAAB5EFE060AED6708B7A21A3D592F9DDEAA3DB4AE49B0 │ │ │ │ │ +CD7A370BA29C6D3DD73275BBF9FDC9F4A6D9E1DA1786EC9168357A5B6AB8981E │ │ │ │ │ +F931667402D9B0D2E971F01885BD6D1E73761FB481D2F53FAC98782852F79F68 │ │ │ │ │ +E8284AA81E3E04A0694B3B87AC81FFCA842BA1CB9200E25A57F8195BFEAFD245 │ │ │ │ │ +767E27596CBD1A88C76E2186FDFC4F5FE8EE2D349E83C9F7DBD83051CCF55CA7 │ │ │ │ │ +52D82A4E0B3EABAF7A003F705F91F17296EDE9F6339AFA52F23D2CF77CB2F64A │ │ │ │ │ +7BBAD1EE318F95B1C83C5B36599C776B1E9AAEAA120B4758CFA0D58C8AA7F34A │ │ │ │ │ +CCF1B7D95763C89FDAE9169413B70A9EDBA43AAA2AF94258BAEC843F6A383128 │ │ │ │ │ +2B11A6D3106BD68D27BBE1C7FD1B30846FDC16D3F8C76854F074A52641DA55D4 │ │ │ │ │ +2CF409E0F731784194E7F48E13A14D9C9C8A4BAD24EFC359C64FC27E5687EBD6 │ │ │ │ │ +A236D62225DC8422D9AC8047241A363F1061FCCFF32B798E08ADBFD0A733AAA5 │ │ │ │ │ +99ABDE3F4CE6CF46D7B187A4216035C5B925052641DCF73ECD25A2A262EE6235 │ │ │ │ │ +38A1B84ACFB341CBBC933B298CDE03719B5D6EB74B401E173D49638D2BE79281 │ │ │ │ │ +F5BFE1A20DD90F3775B1F577E3CCDA98A6BBE379B905E62CE1AC7DAC6B285A4C │ │ │ │ │ +B005D68943CE3B31ECD111AE23752D6D6B2B31CFCF54A951EF27A39E3B602CD0 │ │ │ │ │ +8A8D70AA19CDA6BD650067009B0182141C80A7B38DB33D470C2E8D4A0038FFA2 │ │ │ │ │ +A76065F0CD9FA7BD7B574FAF7988799D364894B5B0F5002E1118FC6E8062B9F1 │ │ │ │ │ +868EEABCA4B0C75936F94952F20F40185BA65E7EB25E18BCB5663078F33A26F0 │ │ │ │ │ +08188C2BB4B8A5051737DE38DBFE050059556B9758A2DB92A4C74F7C4B1D25DA │ │ │ │ │ +F64624F0E4B9E3940DEC3B54C9B0A2CDEDC98DA56C129283917F79B338D25C68 │ │ │ │ │ +FF8225F981BD09C212B01C1734458016E78969A27B991F895F3A9FDB991C41CB │ │ │ │ │ +ED4DFCE2B3CFB41E51A4A00CB798E7FB75C71F5AAAA8E350FCB9469D03815FCA │ │ │ │ │ +F7B297E099389547B9365F1B8BBD90FCD90219BABDE88379C87A4F1B744F4F28 │ │ │ │ │ +956A5166B45C39DCF82E6E55648E901A58EDEDE22F56B1F4CCA53EBE412DF5A4 │ │ │ │ │ +E9FA619F13B58D099DE1B0E5C245630DD55941815797A6D7AAC4EFEAD7C7E595 │ │ │ │ │ +ADF5E6AE5399805D954A97FD6D1EA9D1D9F884BD61D592CA99CB1FBD275193E8 │ │ │ │ │ +ABA5C3A57C8AE5C59C8870BC4D2CB61E49EE2D8354CA0A9E25BE546E948618F9 │ │ │ │ │ +E2A131B8315339C5468F13A5A6BC731999739101BD5CB7FBCB51F6D597684A03 │ │ │ │ │ +3932C226241B1FB7099127B17A330DE81AC6AB42E3C2664F87AA1001AA0DF142 │ │ │ │ │ +1DC6AE523275E6AF210B57337CB1728FE87F9752C8183F2E169A17644DEDCD81 │ │ │ │ │ +AB9F7D9DADB189491EAA6BB8993C9EBEF47DEEB65DFF928710937BED4B9C751A │ │ │ │ │ +C9AA23D16207F0C7574CECE37D956F22FDF10528AAA3F994C76976F4CD6BCA19 │ │ │ │ │ +B48DC9D86E6B414FEC2D7D7AF94B415D736AEC9DBE5FB83D964BF34F879BF15C │ │ │ │ │ +AF896EF2ED169CA928C133FFCA0AEFA8D26F69ED3EAA474F09AC25D022338664 │ │ │ │ │ +09BE95350BA05BFDE64EEEF66886F80532612AE9EE3742CB435AE654014D564C │ │ │ │ │ +3C679CC4FB2DAB5D5BA9EE784BD67FB1498C13B4262629A610C97713F3EB680F │ │ │ │ │ +BEB283DB6A816E566FA10896240E1D755EE4F021B17FE3C959858ED4A57AAE5A │ │ │ │ │ +EDCDF48CF658B9F4E9EC727DA73457AC90003AAB59998824B5646698C30706B2 │ │ │ │ │ +BE206D8B50121B662E904A206324E7A24C6C7C434D6A9555B20D2052C835B78D │ │ │ │ │ +1F56E3E2105FFE6B415AE2FDA375786E981F2BEE8F6123638E2CC31EE429A906 │ │ │ │ │ +F3EE5F12F443C264C8BA0EB761299A07BA6774BD768DBAB387ECBE1B5130F0E2 │ │ │ │ │ +013D047931F3E60EDA8B02D0B6C8B5AD5AD29943F6BA4D8A1DDA05ABCCCF3A18 │ │ │ │ │ +F704AE0DFA5494F24FC74A7A42F76AE325D64EFCBC8A42A1E819643B07CC5899 │ │ │ │ │ +B828E0F52FEA9376C19572D78D9604E07FF8A832EC0DAD45C79C6EA3D9473325 │ │ │ │ │ +285051769C5B69CA6C24450F88989BCA9342525A707090C51EF9EB29A71CF268 │ │ │ │ │ +556DC65DA5CA115D1DEE84AED55027CE57E7F178C82C30A44A37E0FA15FD01A7 │ │ │ │ │ +91C75CD035C20A8BB714AB06073A377A1907E98244BE2484E05204DCE917CC84 │ │ │ │ │ +18AF9C9045F46D06E7B56CB560A48775A0328887F245A76AB74ECE153B603B88 │ │ │ │ │ +FB7AB01097938524C3970D97FA2BCA19E783A502B3DBC4691B6C542D66D46A1C │ │ │ │ │ +B28AB0D4120B492CA56B2140E463779308FAE2E77B7BDA52DADE3E01826D003C │ │ │ │ │ +047818E9765628FB4CEB654698DFC1F3DDF695945C932688FE43F5CE1D1EB38F │ │ │ │ │ +101ADD343F9E363571EF2FD3652A38710B53F1EB8D1DF729ABD09E7B9E1D1514 │ │ │ │ │ +02FF36C2C66CDF5CCD30E1DFC99FFB243F204365C635211DA294640E135498CE │ │ │ │ │ +167FB5D21FB41E615EFC3031C2C3697EBDFCB972917FEA0D9DCC7F3E1BE5AF5D │ │ │ │ │ +4FC276F0857075A7DBDA8AAA92B1C8338F2DF364DCA765AD79EC07C1D9CDCCA2 │ │ │ │ │ +620C59F1589A13B80540B8B185BD0252754B2CC43010A181620862F512F9392F │ │ │ │ │ +991DF9562E7C035652A017766792653EE7AA361222B45B3393CFFA8909733EAC │ │ │ │ │ +15D53EB91822ED512258698FE20B4FE769CDC96B03FE453BD11E19D6BB4750D1 │ │ │ │ │ +97ED06368B87AC1F62853CCFDF9D960209DF99954CEA1B752D28A3367ABC7133 │ │ │ │ │ +DC41E3BBC388C6D4E86744517674A43D47146CD25688E3CF545D8987D3230626 │ │ │ │ │ +47DB5D78040F7E3E26614DA9C200CB440A4C7B083E95400F3B20C3177B0D3057 │ │ │ │ │ +F115DABA45D16B53237184066C258E960871D3BBE1188AB83520 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ @@ -3105,22 +3084,21 @@ │ │ │ │ │ @start /Fa 136[39 39 1[39 39 39 1[39 39 39 39 39 2[39 │ │ │ │ │ 39 39 39 39 39 39 39 39 32[39 17[39 46[{}21 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 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 /Fc 205[30 │ │ │ │ │ 30 49[{}2 49.8132 /CMR6 rf /Fd 205[35 35 49[{}2 66.4176 │ │ │ │ │ -/CMR8 rf /Fe 134[51 2[51 1[38 38 38 2[49 54 81 27 51 │ │ │ │ │ -1[27 54 49 30 43 1[43 1[49 9[100 6[66 2[89 2[50 6[70 │ │ │ │ │ -69 73 9[49 2[49 1[49 49 49 3[27 44[{}30 99.6264 /CMR12 │ │ │ │ │ -rf /Ff 165[99 6[90 2[110 121 126 1[97 6[106 1[117 1[122 │ │ │ │ │ -65[{}9 143.462 /CMBX12 rf /Fg 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 │ │ │ │ │ +/CMR8 rf /Fe 137[51 54 38 38 38 2[49 54 81 27 51 1[27 │ │ │ │ │ +54 49 30 43 1[43 1[49 9[100 6[66 5[50 6[70 69 73 11[49 │ │ │ │ │ +2[49 1[49 3[27 44[{}27 99.6264 /CMR12 rf /Ff 165[99 6[90 │ │ │ │ │ +2[110 121 126 1[97 6[106 1[117 1[122 65[{}9 143.462 /CMBX12 │ │ │ │ │ +rf /Fg 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 } │ │ │ │ │ @@ -3132,18 +3110,18 @@ │ │ │ │ │ %%Page: 1 1 │ │ │ │ │ TeXDict begin 1 0 bop 109 1941 a Fg(In)l(tegrating)43 │ │ │ │ │ b(the)g Ff(SPOOLES)h Fg(2.2)e(Sparse)i(Linear)f(Algebra)g(Library)326 │ │ │ │ │ 2123 y(in)l(to)g(the)h Ff(LANCZOS)e Fg(Blo)t(c)l(k-shifted)h(Lanczos)g │ │ │ │ │ (Eigensolv)l(er)950 2513 y Fe(Clev)m(e)35 b(Ashcraft)737 │ │ │ │ │ 2630 y(Bo)s(eing)d(Phan)m(tom)i(W)-8 b(orks)1753 2593 │ │ │ │ │ y Fd(1)2334 2513 y Fe(Jim)33 b(P)m(atterson)2107 2630 │ │ │ │ │ -y(Bo)s(eing)f(Phan)m(tom)i(W)-8 b(orks)3123 2593 y Fd(2)1664 │ │ │ │ │ -2890 y Fe(Ma)m(y)34 b(17,)e(2024)104 4919 y Fc(1)138 │ │ │ │ │ -4951 y Fb(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 Fa │ │ │ │ │ +y(Bo)s(eing)f(Phan)m(tom)i(W)-8 b(orks)3123 2593 y Fd(2)1657 │ │ │ │ │ +2890 y Fe(June)33 b(20,)f(2025)104 4919 y Fc(1)138 4951 │ │ │ │ │ +y Fb(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 Fa │ │ │ │ │ (cleve.ashcraft@boeing.com)p Fb(.)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 │ │ │ │ │ (e.)104 5193 y Fc(2)138 5224 y Fb(P)-6 b(.)27 b(O.)g(Bo)n(x)h(24346,)h │ │ │ │ │ (Mail)g(Stop)d(7L-22,)j(Seattle,)f(W)-6 b(ashington)27 │ │ │ │ │ ├── ps2ascii {} │ │ │ │ │ │ @@ -1,11 +1,11 @@ │ │ │ │ │ │ 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 │ │ │ │ │ │ - May 17, 2024 │ │ │ │ │ │ + June 20, 2025 │ │ │ │ │ │ 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. │ │ │ ├── ./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 2024.05.17:2217 │ │ │ │ │ +%DVIPSSource: TeX output 2025.06.20:0449 │ │ │ │ │ %%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 │ │ │ │ │ @@ -1758,22 +1758,21 @@ │ │ │ │ │ /UnderlinePosition -100 def │ │ │ │ │ /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 49 /one put │ │ │ │ │ dup 50 /two put │ │ │ │ │ -dup 52 /four put │ │ │ │ │ -dup 55 /seven put │ │ │ │ │ +dup 53 /five put │ │ │ │ │ dup 58 /colon put │ │ │ │ │ -dup 77 /M put │ │ │ │ │ -dup 97 /a put │ │ │ │ │ -dup 121 /y put │ │ │ │ │ +dup 74 /J put │ │ │ │ │ +dup 101 /e put │ │ │ │ │ +dup 110 /n put │ │ │ │ │ +dup 117 /u put │ │ │ │ │ readonly def │ │ │ │ │ currentdict end │ │ │ │ │ currentfile eexec │ │ │ │ │ D9D66F633B846AB284BCF8B0411B772DE5CE32340DC6F28AF40857E4451976E7 │ │ │ │ │ 5182433CF9F333A38BD841C0D4E68BF9E012EB32A8FFB76B5816306B5EDF7C99 │ │ │ │ │ 8B3A16D9B4BC056662E32C7CD0123DFAEB734C7532E64BBFBF5A60336E646716 │ │ │ │ │ EFB852C877F440D329172C71F1E5D59CE9473C26B8AEF7AD68EF0727B6EC2E0C │ │ │ │ │ @@ -1954,72 +1953,64 @@ │ │ │ │ │ 7CA1534C4D5B05FC33F83790ECFD7641DF3FB94289E2A1F6E7D29AB1228A867A │ │ │ │ │ 6E1EF0E9C6F899B491DC18401C2C0A05FFFED46A72C245F7529B8EA55A038082 │ │ │ │ │ 8512307217D2A233C37004085BA3AEE379269F9FA7D0ADB4B19A95CC2AFE686E │ │ │ │ │ 55D88E47257C1FE6F235FEA295910569FE6DD5995512562359CC821E85A6C7A5 │ │ │ │ │ 79B470A9E340A6985189FF8B6AF914A6B0ECF93F47903221F95DE894A8F05B05 │ │ │ │ │ B7D99CD533EC5F931B18E6B39BECF67FA2D6DD1AEC76772B068BE06335A94C05 │ │ │ │ │ 7A4DDEE77B66101DA855C17AC312600370B34E31F5EC3A01300A8EB60B4C9767 │ │ │ │ │ -1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004B9BA1CC │ │ │ │ │ -580D3C6BDA4DC1B80B4365F1C80512453FC5316EC2D928FB731C3D6403E3C18B │ │ │ │ │ -E8424D644DF5E9A2134229C5C91CA68DB8E85BA2BB40F538F585DA6FA4037718 │ │ │ │ │ -B8053EBBA1E765346BCD5BDAA6C38115D31611D8A87A2238C145F2DA2F92E4DF │ │ │ │ │ -3987BD9C4D2A3D460E8941A68B125BCD9EE4F9FD262C4C8A71F47A2C81975635 │ │ │ │ │ -F1B981C274C53FA2ACCDE4C9D0A7C62D6C1EFF91CFC6712CA6A9F333C9564FCB │ │ │ │ │ -2A70F0AD715A79B10A08AB069E2A3C93BC0AED19D0CA10134B8DDDE8AF548DB2 │ │ │ │ │ -3A4AAA9C29682CF135BB767DAA16169A127EB50A7EECEB6480CF56A7D0F8AC56 │ │ │ │ │ -4A5090B3D75A790372886AF568D94C8165975A05BFBFDF1FFBA45F70700BB9E0 │ │ │ │ │ -57F3249EF9E9C8AD9CBCF6E4FD592DC4CDD2CC7C0BC3130C1059096C657BE453 │ │ │ │ │ -A2CBACE93420210E27AF56CA229BD6D982FB68B3FDC6D44478B922C4231C47EE │ │ │ │ │ -E500232F6C11D92DEB955F66DF52B92B22E7352790CC2DCBAC53965D57AC2920 │ │ │ │ │ -68B7D520DE25047146EFEB06B9AD4E2A94243C7E5239F0BC2FC312B16051D52C │ │ │ │ │ -0B92C217B6B42997321AE4F8BB066754B7AA3F15069EF59224E8A442CE471AA7 │ │ │ │ │ -E8049A3DD9EDA09CCEE4998998661CF7DB35E952F6C65DAEB3013951C59F3E09 │ │ │ │ │ -157F313B0237876E1C0190F0473819570B8C0205AADF05D787CC00979CFB327A │ │ │ │ │ -289382B22DDA6F12804ED0ED5B179E36A995A2A59E1B66E75130DBE9109C813B │ │ │ │ │ -94403E0DEA8314A1E9DB474D7FA83C0BAFD08033E6A6215844C1D26BE15F1251 │ │ │ │ │ -A1605E8DF9A9C601ED37379530BC1C82BE5463C6C711C5652BFD6262485AA9CA │ │ │ │ │ -B8C4A117593001D08D980041E2A83C190DCE8E6CD3D334E5CC19FC05DB30F7F7 │ │ │ │ │ -24A305C4DBB31F0651392B99D44B4302333BDF7E326FD256DD75D309C6E73F85 │ │ │ │ │ -FA71B35FD1F9BEFF4C7A1076362EEB0A85492933B6006086A7B8C1928CF2D1EE │ │ │ │ │ -FD4344409257BB802C117E739960821CD3C88BFBA5669FF16F610AD638AF3677 │ │ │ │ │ -8674C985E6767253ED5769F71BEA5E9BB02A751F9E62EE2B18AC19D975FDEAE9 │ │ │ │ │ -8B8822367FF177A7E850766DE99ED3366D46464612926430012212A90F8E85F4 │ │ │ │ │ -4760B40D5B86B90819EE410382C23E86DCAF4F0FF5DFEB2C285965F4DCF2FB2B │ │ │ │ │ -457C0A0427A8D4ADA514E9DACD0F9367E1DA225DB21DA4DDAE33F2B529686D92 │ │ │ │ │ -AC085B345565F9DFFA012FD494DBB2E0B44A0787B2B72DC8D25399DAAE8864B7 │ │ │ │ │ -E84AA99DAFCEAF18F8B41882720316450F1B1CA48B418C9736E5CE4AFF996111 │ │ │ │ │ -5F7FE80958B6A3498508E9693CB134402D92E30D4C2939070D4647E13682290E │ │ │ │ │ -1D0820A3FCA7147157D09D1A40771F214EAE7DD743EA26839E535CA186C05CB8 │ │ │ │ │ -4874988AA1104D85AF0220FE7224344FF624E794BD2454E1C0AC971522FBECBA │ │ │ │ │ -B2497F25CD621B77EC5160973EF5ECC39C183DC051B0DFCB090194A2525BD96E │ │ │ │ │ -28593FDA80D8D259F039416D5F9AF0AD3C9A105B49DAF6E681921E369B7666C6 │ │ │ │ │ -2B73DB37447B00AE96317C2F1C44FB6E6EFD740BAB20FA03A8CE018EC8415582 │ │ │ │ │ -FB06E88A2971E3A480FB1EB4FE93CC7E5179721CAABEE88742B13CF0405F49F4 │ │ │ │ │ -945E587668C821D8C06D6847B6DF84CAFFCD4628670D551FC5F7236875BE1207 │ │ │ │ │ -634BA7F70A19B658FAE7D86F6D00ED28FBF29CC585DEE279325EEF8B0CCB6149 │ │ │ │ │ -E46E638C73D75148F18A636DBC2DD96ED34F68A5A09A3700B1EA34B2D142807C │ │ │ │ │ -F8709D81180783548EAE6F457BF968602076A1069163E3C15BBCEF659C6CF2E6 │ │ │ │ │ -0BB01BDC8E503802CC7969A5B8477E9788C5249B23B19669F5075E089738E49A │ │ │ │ │ -8671D7C1B1B47652F3D78BF2FF74EDB44BA5B092E8D5B85001E97F69D54AEEFC │ │ │ │ │ -88FC3CA1B0D5BAC39263B371005BCFA19AD197A31CC34D0BD55C2CA18C60C485 │ │ │ │ │ -5993F736EF1DD2C5D2B4D50B3D498861B4DF5E7AFF614BBCA4C2E6BECC0DCEF5 │ │ │ │ │ -95F0D686188014C530D8E37650CDCAE721B4AFB0F178BC744BDDDED45DAB7FEB │ │ │ │ │ -A10B975E26099E3DC61116D6BF554574F948895B88EEFE03DCC5351190836AD4 │ │ │ │ │ -EBC1AC55C6D099A8E7B0A372D290C481F44FA464B9C11A0BC991CB045E0AAAC4 │ │ │ │ │ -5C73CA43A4F17D1ADDD33D1B917FF95BFF411C8409F41553B1BC97DE47E3A1F4 │ │ │ │ │ -A5C1D1B7B1BF7E2507AC53956C141411F4F657E37981996DD7BB7ADB2CB6AE01 │ │ │ │ │ -73D0876B8F896F626D5022FE53BA34D5668BD698BE8D5CCAD083CBCEF440BE6A │ │ │ │ │ -8090EB1CDEE5F99C8988650BD4E539B357C31C597D8A9104A9D5967D4E906CAD │ │ │ │ │ -2A65575A884B1C5F6CC509E742FA9DDD66494F219178161AF72C50848E226A95 │ │ │ │ │ -A8C247FF9FF0BABD073021271B5C0692F9BE220071DAB09E5A026629371EE3C4 │ │ │ │ │ -A6E4FA94625D87A5B66EF077ED54C72B1052AEAA9637B30C76EF8EB04AD5F476 │ │ │ │ │ -D15F1C93C0BC6E0F67B366097BBED03FE82C040F9EF02866159B46854E11D44F │ │ │ │ │ -54AE6748A7E61B993A4EECD3B8BE3B5897A66BBCDFE24F65BC2AD5AB49048CF1 │ │ │ │ │ -647203823F84DF5CB483096F9D96AEE3A2855E479B72A14A67C633CE99C101CF │ │ │ │ │ -EFAE939BF9B02E710D │ │ │ │ │ +1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004ACD1870 │ │ │ │ │ +A5EA947858F5795870BFE1343AD803FB854BF8F5A4E794E8EC57BE41DB5B8734 │ │ │ │ │ +13E47950F29A81EA0C81EA798863883D7F41F78325CA190CBBFFE822AE494550 │ │ │ │ │ +4BE83703071FC9512D128927AF3F63CEF8F86ABE1E15D7B4DDD39576E7DFF45E │ │ │ │ │ +3CB4115AAB1830DE8647B915DB4BEBEB5235C281E098B899BAB951D8D5798F01 │ │ │ │ │ +7F7C47336D31438E5126738AFEAB29E9A7CBE06DE4DD604477B542D2620DFD58 │ │ │ │ │ +28FE34238572F23C5A8EB7ACEE1E154DA13FC1A5AA67A3BA8C5CDFB2B80312C9 │ │ │ │ │ +BC9FAE56D08DDFA9498E6EF0D0F6BD18B3923E0B670B0740528BC843610736CB │ │ │ │ │ +80228C105C2F72C3C22D610C3D8C268DEEA2AEEE3221E198E79FE2966487360C │ │ │ │ │ +84AE08AC326F48B21447652121B1EB68AF856055EEA65B6B625BF622CBFC2D1C │ │ │ │ │ +EF943CC4CAF2C715782C9EF9A9BA4689BFC6B6A82F8D55795BE8111E2C7DE520 │ │ │ │ │ +367362304B6A48186C842033E715A46265A352472F4F7313248EBCD26BEA97E7 │ │ │ │ │ +B814A61D4B7ADCB5C5F21AA34E0C1269E8426DBFB511DE6E26B960456C8F8520 │ │ │ │ │ +5F0DD382289A62AF0B935EDB5B2394538C5F0EE72962D2F98F3C38CD7C027B9F │ │ │ │ │ +E230E67E40FEFBDED06B3423C9DFD669E6B5BC913E0FF75786A64A6C11D4FE89 │ │ │ │ │ +1B918DC0E953C52CFD153063CD0D2A78B43F8712243845E6F2CBA1DB610F403D │ │ │ │ │ +A98D06D95FF44C7AC029092B666A8B0DCEA95B34F5ACC10E8611BADE6A24469C │ │ │ │ │ +0C01D95BFB445FA22CD38D033E4D24E006BB9D54EE41EF7AD5AC9C299721F61A │ │ │ │ │ +F01B6EDCDF428BD9195A13C5B1027358F8A203F828A1DD9622243B2D76C6F1BA │ │ │ │ │ +9F2D7E9D4879FC668ABC750CD25415DC6CCF2257C28F78D3F9BE499CC0FF2F80 │ │ │ │ │ +2C2CD1DEFABD6668FCA76E1D629A344333E33DA24B86D2E9F8F5EE1C29974640 │ │ │ │ │ +C3E78E999BAB313400041DADDDFDBFFCC419F129A84F4D412B79E8BE4511CA00 │ │ │ │ │ +F92A4F3CDD2E51345D3965C104F06B6503445DC20224CB7606A9D7D5F9EE45E6 │ │ │ │ │ +1B2963DA96AA2AB1BA5BE29656E666E4D0E122DE58EEA68E04ED76438DA03E65 │ │ │ │ │ +B80055A86B7B2A26BAE6BBB8835E17F9696E9B3CD34571BA75C76D4D2CCC48F1 │ │ │ │ │ +7534C1EF9127E374D65D05B8072E08D6C72A0B4A35EA0DD717743C66D105CCD8 │ │ │ │ │ +7355F13E9C38C1A4351624E689ED7909100942FA0474842EE44DEC3279E1A1CD │ │ │ │ │ +8064666EB845CA7C3E906B67C0BF96A28D514DB2E4A1E4AF287350B03762A2CF │ │ │ │ │ +13B18AC3F5D2F3B74A1D50267C03EFB74B888E1D24ABEEA4A885F4D0BF14C0D8 │ │ │ │ │ +289AC79D6D98E2A2C831672FB1F3457564CD161ADC3AF610D88201AB5B0C10CB │ │ │ │ │ +5ECCC2D5C4AF39C8CB3044BF9EC791BA45D29C2B51EA0483D19822C264CE6FA3 │ │ │ │ │ +5C97F2DF5A78CB93528E99B9ED7CB121C83130C129B849B52A36EBD88AF19DD3 │ │ │ │ │ +C5CABE831027388EF86BD5CBD90AAAC089775938A321C44D4DDA67A51312D8AB │ │ │ │ │ +C509DDBE7044A107AB2BE9C4C9556F85C529B174A7778B489BF28EC07A834542 │ │ │ │ │ +8B31F2925C21FB2096877711F998763D5A8495002B8E080AF8DBB1B3106EDDBA │ │ │ │ │ +35121D52E0846A7AF3ABEDF87BDE4FA665673A9B80CA538B98F873947AA17EF4 │ │ │ │ │ +9BB182917E9D79BC7EC681E93710D6A1D6B0E4A7FA9452FC1C431808174F3AB7 │ │ │ │ │ +F3914FBC86CB34E8583457243C3C7BE4BC166C7397689BC6FFB82EA2967E88EE │ │ │ │ │ +464F96EDA144DE2B64401B8E577ABCA2D826FE0B92E21FFAE3E81EBB6B6EB36E │ │ │ │ │ +9B1A8FE3884CA398C03135FD49D51724FC1268E9482E41FAEA2FC6C809006B8F │ │ │ │ │ +5D4F9E038450AD3A6041C16FD1C7E5FC80C0E033CE57E64863E014531D94DF1E │ │ │ │ │ +31D7D038AFCB60715AA73C1E96F113A24C5AF35BBEB61C4D079ED034ED83AA4A │ │ │ │ │ +E12448E618330463304788BCF40561CD63167B3BF144F408E2B89E60B8BA13EF │ │ │ │ │ +3B57D286FD23D4FA8BAEFF98DC1188B1982956CC1DCAEFC7D949B7B4E3BE8F8A │ │ │ │ │ +BFE2C9D938DD13EFEE7123576608D9396F260907DA98AE2D3DD5822306CBC8A6 │ │ │ │ │ +B083C697DDA3C62EE7879436A9FD8EE0034B105105B3F122F893EA2126EBE8A9 │ │ │ │ │ +5CBF2BD248DD9FBEF0040C25797BD13B69A8C9F0D4E4F935C61ED30487CCDB1A │ │ │ │ │ +0339006E78EE1755929D2412776EC7DB1F666DBDD28EA8AC7397F809C7F38A41 │ │ │ │ │ +5B3BF6C75F4F35C90141EB08377AF452CF840FEA938805F9D14E02DC29215B4E │ │ │ │ │ +F1EB │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ @@ -4986,15 +4977,15 @@ │ │ │ │ │ 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 23[45 19[83 18[25 2[45 2[45 1[45 45 45 3[25 44[{}10 │ │ │ │ │ +138[51 6[51 8[40 26[47 15[25 4[45 2[45 1[45 3[25 44[{}9 │ │ │ │ │ 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 │ │ │ │ │ @@ -5131,17 +5122,17 @@ │ │ │ │ │ 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 1107 4 v │ │ │ │ │ -1289 w Fl(FrontMtx)28 b Ff(:)41 b Fh(DRAFT)30 b Ff(Ma)m(y)i(17,)f(2024) │ │ │ │ │ -p 2793 100 V 141 399 a Fm(The)44 b(factorization)j(is)d(p)s(erformed)f │ │ │ │ │ +TeXDict begin 2 1 bop 0 100 a Fm(2)p 136 100 1101 4 v │ │ │ │ │ +1282 w Fl(FrontMtx)28 b Ff(:)41 b Fh(DRAFT)30 b Ff(June)g(20,)h(2025)p │ │ │ │ │ +2800 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 │ │ │ │ │ @@ -5225,17 +5216,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 1107 4 v 1289 100 a Fl(FrontMtx)28 │ │ │ │ │ -b Ff(:)41 b Fh(DRAFT)121 b Ff(Ma)m(y)31 b(17,)h(2024)p │ │ │ │ │ -2746 100 V 1107 w Fm(3)137 399 y Fi(\210)45 b Fm(An)35 │ │ │ │ │ +TeXDict begin 3 2 bop 91 100 1101 4 v 1282 100 a Fl(FrontMtx)28 │ │ │ │ │ +b Ff(:)41 b Fh(DRAFT)121 b Ff(June)29 b(20,)j(2025)p │ │ │ │ │ +2753 100 V 1101 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 │ │ │ │ │ @@ -5319,23 +5310,23 @@ │ │ │ │ │ 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 1107 4 v │ │ │ │ │ -1289 w Fl(FrontMtx)28 b Ff(:)41 b Fh(DRAFT)30 b Ff(Ma)m(y)i(17,)f(2024) │ │ │ │ │ -p 2793 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 │ │ │ │ │ +TeXDict begin 4 3 bop 0 100 a Fm(4)p 136 100 1101 4 v │ │ │ │ │ +1282 w Fl(FrontMtx)28 b Ff(:)41 b Fh(DRAFT)30 b Ff(June)g(20,)h(2025)p │ │ │ │ │ +2800 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(for)e │ │ │ │ │ (the)i(factorization)h(and)e(forw)m(ard)g(and)227 1033 │ │ │ │ │ y(bac)m(ksolv)m(es.)137 1217 y Fi(\210)45 b Fm(The)37 │ │ │ │ │ @@ -5391,17 +5382,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 1107 4 v 1289 100 a Fl(FrontMtx)28 │ │ │ │ │ -b Ff(:)41 b Fh(DRAFT)121 b Ff(Ma)m(y)31 b(17,)h(2024)p │ │ │ │ │ -2746 100 V 1107 w Fm(5)137 399 y Fi(\210)45 b Fl(int)i(dataMode)28 │ │ │ │ │ +TeXDict begin 5 4 bop 91 100 1101 4 v 1282 100 a Fl(FrontMtx)28 │ │ │ │ │ +b Ff(:)41 b Fh(DRAFT)121 b Ff(June)29 b(20,)j(2025)p │ │ │ │ │ +2753 100 V 1101 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 │ │ │ │ │ @@ -5458,17 +5449,17 @@ │ │ │ │ │ (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 1107 4 v │ │ │ │ │ -1289 w Fl(FrontMtx)28 b Ff(:)41 b Fh(DRAFT)30 b Ff(Ma)m(y)i(17,)f(2024) │ │ │ │ │ -p 2793 100 V 137 399 a Fi(\210)45 b Fl(SubMtxManager)f(*manager)30 │ │ │ │ │ +TeXDict begin 6 5 bop 0 100 a Fm(6)p 136 100 1101 4 v │ │ │ │ │ +1282 w Fl(FrontMtx)28 b Ff(:)41 b Fh(DRAFT)30 b Ff(June)g(20,)h(2025)p │ │ │ │ │ +2800 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 │ │ │ │ │ @@ -5528,17 +5519,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 1107 4 v 1289 100 a Fl(FrontMtx)28 │ │ │ │ │ -b Ff(:)41 b Fh(DRAFT)121 b Ff(Ma)m(y)31 b(17,)h(2024)p │ │ │ │ │ -2746 100 V 1107 w Fm(7)0 399 y Fb(1.2.1)112 b(Basic)38 │ │ │ │ │ +TeXDict begin 7 6 bop 91 100 1101 4 v 1282 100 a Fl(FrontMtx)28 │ │ │ │ │ +b Ff(:)41 b Fh(DRAFT)121 b Ff(June)29 b(20,)j(2025)p │ │ │ │ │ +2753 100 V 1101 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) │ │ │ │ │ @@ -5597,18 +5588,18 @@ │ │ │ │ │ (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 1107 4 v │ │ │ │ │ -1289 w Fl(FrontMtx)28 b Ff(:)41 b Fh(DRAFT)30 b Ff(Ma)m(y)i(17,)f(2024) │ │ │ │ │ -p 2793 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 │ │ │ │ │ +TeXDict begin 8 7 bop 0 100 a Fm(8)p 136 100 1101 4 v │ │ │ │ │ +1282 w Fl(FrontMtx)28 b Ff(:)41 b Fh(DRAFT)30 b Ff(June)g(20,)h(2025)p │ │ │ │ │ +2800 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 │ │ │ │ │ @@ -5675,17 +5666,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 1107 4 v 1289 100 a Fl(FrontMtx)28 │ │ │ │ │ -b Ff(:)41 b Fh(DRAFT)121 b Ff(Ma)m(y)31 b(17,)h(2024)p │ │ │ │ │ -2746 100 V 1107 w Fm(9)66 399 y(10.)46 b Fl(SubMtx)g(*)i │ │ │ │ │ +TeXDict begin 9 8 bop 91 100 1101 4 v 1282 100 a Fl(FrontMtx)28 │ │ │ │ │ +b Ff(:)41 b Fh(DRAFT)121 b Ff(June)29 b(20,)j(2025)p │ │ │ │ │ +2753 100 V 1101 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 │ │ │ │ │ @@ -5757,17 +5748,17 @@ │ │ │ │ │ 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 1085 4 │ │ │ │ │ -v 1267 w Fl(FrontMtx)28 b Ff(:)41 b Fh(DRAFT)30 b Ff(Ma)m(y)i(17,)f │ │ │ │ │ -(2024)p 2816 100 V 0 399 a Fb(1.2.3)112 b(Initialization)39 │ │ │ │ │ +TeXDict begin 10 9 bop 0 100 a Fm(10)p 182 100 1078 4 │ │ │ │ │ +v 1260 w Fl(FrontMtx)28 b Ff(:)41 b Fh(DRAFT)30 b Ff(June)f(20,)j(2025) │ │ │ │ │ +p 2823 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 │ │ │ │ │ @@ -5835,17 +5826,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 1085 4 v 1266 100 a Fl(FrontMtx)28 │ │ │ │ │ -b Ff(:)41 b Fh(DRAFT)121 b Ff(Ma)m(y)32 b(17,)f(2024)p │ │ │ │ │ -2723 100 V 1085 w Fm(11)111 399 y(2.)46 b Fl(char)h │ │ │ │ │ +TeXDict begin 11 10 bop 91 100 1078 4 v 1259 100 a Fl(FrontMtx)28 │ │ │ │ │ +b Ff(:)41 b Fh(DRAFT)121 b Ff(June)29 b(20,)j(2025)p │ │ │ │ │ +2730 100 V 1078 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 │ │ │ │ │ @@ -5908,17 +5899,17 @@ │ │ │ │ │ (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 1085 │ │ │ │ │ -4 v 1267 w Fl(FrontMtx)28 b Ff(:)41 b Fh(DRAFT)30 b Ff(Ma)m(y)i(17,)f │ │ │ │ │ -(2024)p 2816 100 V 111 399 a Fm(8.)46 b Fl(ChvList)g(*)i │ │ │ │ │ +TeXDict begin 12 11 bop 0 100 a Fm(12)p 182 100 1078 │ │ │ │ │ +4 v 1260 w Fl(FrontMtx)28 b Ff(:)41 b Fh(DRAFT)30 b Ff(June)f(20,)j │ │ │ │ │ +(2025)p 2823 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 │ │ │ │ │ @@ -5986,18 +5977,18 @@ │ │ │ │ │ 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 1085 4 v 1266 100 a Fl(FrontMtx)28 │ │ │ │ │ -b Ff(:)41 b Fh(DRAFT)121 b Ff(Ma)m(y)32 b(17,)f(2024)p │ │ │ │ │ -2723 100 V 1085 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 │ │ │ │ │ +TeXDict begin 13 12 bop 91 100 1078 4 v 1259 100 a Fl(FrontMtx)28 │ │ │ │ │ +b Ff(:)41 b Fh(DRAFT)121 b Ff(June)29 b(20,)j(2025)p │ │ │ │ │ +2730 100 V 1078 w Fm(13)227 399 y(This)27 b(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 │ │ │ │ │ Fm(ob)5 b(ject)25 b(is)e(unc)m(hanged)227 737 y(b)m(y)31 │ │ │ │ │ @@ -6064,17 +6055,17 @@ │ │ │ │ │ (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 1085 │ │ │ │ │ -4 v 1267 w Fl(FrontMtx)28 b Ff(:)41 b Fh(DRAFT)30 b Ff(Ma)m(y)i(17,)f │ │ │ │ │ -(2024)p 2816 100 V 337 399 a Fi(\210)45 b Fl(cpus[6])29 │ │ │ │ │ +TeXDict begin 14 13 bop 0 100 a Fm(14)p 182 100 1078 │ │ │ │ │ +4 v 1260 w Fl(FrontMtx)28 b Ff(:)41 b Fh(DRAFT)30 b Ff(June)f(20,)j │ │ │ │ │ +(2025)p 2823 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 │ │ │ │ │ @@ -6136,17 +6127,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 1085 4 v 1266 100 a Fl(FrontMtx)28 │ │ │ │ │ -b Ff(:)41 b Fh(DRAFT)121 b Ff(Ma)m(y)32 b(17,)f(2024)p │ │ │ │ │ -2723 100 V 1085 w Fm(15)227 399 y(and)c(up)s(date)g(matrices)h(are)g │ │ │ │ │ +TeXDict begin 15 14 bop 91 100 1078 4 v 1259 100 a Fl(FrontMtx)28 │ │ │ │ │ +b Ff(:)41 b Fh(DRAFT)121 b Ff(June)29 b(20,)j(2025)p │ │ │ │ │ +2730 100 V 1078 w Fm(15)227 399 y(and)27 b(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 │ │ │ │ │ @@ -6218,17 +6209,17 @@ │ │ │ │ │ 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 1085 │ │ │ │ │ -4 v 1267 w Fl(FrontMtx)28 b Ff(:)41 b Fh(DRAFT)30 b Ff(Ma)m(y)i(17,)f │ │ │ │ │ -(2024)p 2816 100 V 0 399 a Fb(1.2.8)112 b(P)m(ostpro)s(cessing)38 │ │ │ │ │ +TeXDict begin 16 15 bop 0 100 a Fm(16)p 182 100 1078 │ │ │ │ │ +4 v 1260 w Fl(FrontMtx)28 b Ff(:)41 b Fh(DRAFT)30 b Ff(June)f(20,)j │ │ │ │ │ +(2025)p 2823 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 │ │ │ │ │ @@ -6298,17 +6289,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 1085 4 v 1266 100 a Fl(FrontMtx)28 │ │ │ │ │ -b Ff(:)41 b Fh(DRAFT)121 b Ff(Ma)m(y)32 b(17,)f(2024)p │ │ │ │ │ -2723 100 V 1085 w Fm(17)227 399 y(This)d(metho)s(d)g(creates)h(and)f │ │ │ │ │ +TeXDict begin 17 16 bop 91 100 1078 4 v 1259 100 a Fl(FrontMtx)28 │ │ │ │ │ +b Ff(:)41 b Fh(DRAFT)121 b Ff(June)29 b(20,)j(2025)p │ │ │ │ │ +2730 100 V 1078 w Fm(17)227 399 y(This)c(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 │ │ │ │ │ @@ -6376,17 +6367,17 @@ │ │ │ │ │ 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 1085 │ │ │ │ │ -4 v 1267 w Fl(FrontMtx)28 b Ff(:)41 b Fh(DRAFT)30 b Ff(Ma)m(y)i(17,)f │ │ │ │ │ -(2024)p 2816 100 V 111 399 a Fm(8.)46 b Fl(void)h │ │ │ │ │ +TeXDict begin 18 17 bop 0 100 a Fm(18)p 182 100 1078 │ │ │ │ │ +4 v 1260 w Fl(FrontMtx)28 b Ff(:)41 b Fh(DRAFT)30 b Ff(June)f(20,)j │ │ │ │ │ +(2025)p 2823 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 │ │ │ │ │ @@ -6459,17 +6450,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 1085 4 v 1266 100 a Fl(FrontMtx)28 │ │ │ │ │ -b Ff(:)41 b Fh(DRAFT)121 b Ff(Ma)m(y)32 b(17,)f(2024)p │ │ │ │ │ -2723 100 V 1085 w Fm(19)337 399 y Fi(\210)45 b Fl(cpus[4])29 │ │ │ │ │ +TeXDict begin 19 18 bop 91 100 1078 4 v 1259 100 a Fl(FrontMtx)28 │ │ │ │ │ +b Ff(:)41 b Fh(DRAFT)121 b Ff(June)29 b(20,)j(2025)p │ │ │ │ │ +2730 100 V 1078 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 │ │ │ │ │ @@ -6531,17 +6522,17 @@ │ │ │ │ │ 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 1085 │ │ │ │ │ -4 v 1267 w Fl(FrontMtx)28 b Ff(:)41 b Fh(DRAFT)30 b Ff(Ma)m(y)i(17,)f │ │ │ │ │ -(2024)p 2816 100 V 227 399 a Fm(This)e(metho)s(d)g(computes)g(and)g │ │ │ │ │ +TeXDict begin 20 19 bop 0 100 a Fm(20)p 182 100 1078 │ │ │ │ │ +4 v 1260 w Fl(FrontMtx)28 b Ff(:)41 b Fh(DRAFT)30 b Ff(June)f(20,)j │ │ │ │ │ +(2025)p 2823 100 V 227 399 a Fm(This)d(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 │ │ │ │ │ @@ -6617,17 +6608,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 1085 4 v 1266 100 a Fl(FrontMtx)28 │ │ │ │ │ -b Ff(:)41 b Fh(DRAFT)121 b Ff(Ma)m(y)32 b(17,)f(2024)p │ │ │ │ │ -2723 100 V 1085 w Fm(21)111 399 y(7.)46 b Fl(int)h │ │ │ │ │ +TeXDict begin 21 20 bop 91 100 1078 4 v 1259 100 a Fl(FrontMtx)28 │ │ │ │ │ +b Ff(:)41 b Fh(DRAFT)121 b Ff(June)29 b(20,)j(2025)p │ │ │ │ │ +2730 100 V 1078 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 │ │ │ │ │ @@ -6690,17 +6681,17 @@ │ │ │ │ │ 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 1085 │ │ │ │ │ -4 v 1267 w Fl(FrontMtx)28 b Ff(:)41 b Fh(DRAFT)30 b Ff(Ma)m(y)i(17,)f │ │ │ │ │ -(2024)p 2816 100 V 500 399 a Fe({)45 b Fl(type)i(=)g(2)h(\(SPOOLES)p │ │ │ │ │ +TeXDict begin 22 21 bop 0 100 a Fm(22)p 182 100 1078 │ │ │ │ │ +4 v 1260 w Fl(FrontMtx)28 b Ff(:)41 b Fh(DRAFT)30 b Ff(June)f(20,)j │ │ │ │ │ +(2025)p 2823 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 │ │ │ │ │ @@ -6770,17 +6761,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 1085 4 v 1266 100 a Fl(FrontMtx)28 │ │ │ │ │ -b Ff(:)41 b Fh(DRAFT)121 b Ff(Ma)m(y)32 b(17,)f(2024)p │ │ │ │ │ -2723 100 V 1085 w Fm(23)337 399 y Fi(\210)45 b Fm(The)30 │ │ │ │ │ +TeXDict begin 23 22 bop 91 100 1078 4 v 1259 100 a Fl(FrontMtx)28 │ │ │ │ │ +b Ff(:)41 b Fh(DRAFT)121 b Ff(June)29 b(20,)j(2025)p │ │ │ │ │ +2730 100 V 1078 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 │ │ │ │ │ @@ -6870,16 +6861,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 1085 4 v 1266 100 a Fl(FrontMtx)28 │ │ │ │ │ -b Ff(:)41 b Fh(DRAFT)121 b Ff(Ma)m(y)32 b(17,)f(2024)p │ │ │ │ │ -2723 100 V 1085 w Fm(25)0 399 y Fl(FrontMtx)p 390 399 │ │ │ │ │ +TeXDict begin 25 24 bop 91 100 1078 4 v 1259 100 a Fl(FrontMtx)28 │ │ │ │ │ +b Ff(:)41 b Fh(DRAFT)121 b Ff(June)29 b(20,)j(2025)p │ │ │ │ │ +2730 100 V 1078 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 May 17, 2024 │ │ │ │ │ │ + 2 FrontMtx : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 3 │ │ │ │ │ │ + FrontMtx : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 4 FrontMtx : DRAFT June 20, 2025 │ │ │ │ │ │ • 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 May 17, 2024 5 │ │ │ │ │ │ + FrontMtx : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 6 FrontMtx : DRAFT June 20, 2025 │ │ │ │ │ │ • 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 May 17, 2024 7 │ │ │ │ │ │ + FrontMtx : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 8 FrontMtx : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 9 │ │ │ │ │ │ + FrontMtx : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 10 FrontMtx : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 11 │ │ │ │ │ │ + FrontMtx : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 12 FrontMtx : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 13 │ │ │ │ │ │ + FrontMtx : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 14 FrontMtx : DRAFT June 20, 2025 │ │ │ │ │ │ • 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 May 17, 2024 15 │ │ │ │ │ │ + FrontMtx : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 16 FrontMtx : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 17 │ │ │ │ │ │ + FrontMtx : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 18 FrontMtx : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 19 │ │ │ │ │ │ + FrontMtx : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 20 FrontMtx : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 21 │ │ │ │ │ │ + FrontMtx : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 22 FrontMtx : DRAFT June 20, 2025 │ │ │ │ │ │ – 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 May 17, 2024 23 │ │ │ │ │ │ + FrontMtx : DRAFT June 20, 2025 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 May 17, 2024 25 │ │ │ │ │ │ + FrontMtx : DRAFT June 20, 2025 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 2024.05.17:2217 │ │ │ │ │ +%DVIPSSource: TeX output 2025.06.20:0449 │ │ │ │ │ %%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 │ │ │ │ │ @@ -3344,33 +3344,31 @@ │ │ │ │ │ /UnderlinePosition -100 def │ │ │ │ │ /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 49 /one put │ │ │ │ │ dup 50 /two put │ │ │ │ │ -dup 52 /four put │ │ │ │ │ -dup 55 /seven put │ │ │ │ │ +dup 53 /five put │ │ │ │ │ dup 70 /F put │ │ │ │ │ -dup 77 /M put │ │ │ │ │ +dup 74 /J put │ │ │ │ │ dup 79 /O put │ │ │ │ │ dup 84 /T put │ │ │ │ │ dup 97 /a 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 │ │ │ │ │ dup 115 /s put │ │ │ │ │ dup 116 /t put │ │ │ │ │ -dup 121 /y put │ │ │ │ │ +dup 117 /u put │ │ │ │ │ readonly def │ │ │ │ │ currentdict end │ │ │ │ │ currentfile eexec │ │ │ │ │ D9D66F633B846AB284BCF8B0411B772DE5CE32340DC6F28AF40857E4451976E7 │ │ │ │ │ 5182433CF9F333A38BD841C0D4E68BF9E012EB32A8FFB76B5816306B5EDF7C99 │ │ │ │ │ 8B3A16D9B4BC056662E32C7CD0123DFAEB734C7532E64BBFBF5A60336E646716 │ │ │ │ │ EFB852C877F440D329172C71F1E5D59CE9473C26B8AEF7AD68EF0727B6EC2E0C │ │ │ │ │ @@ -3547,138 +3545,123 @@ │ │ │ │ │ 60F5C3F629F7BC5A27C207D70DE63FBE0E023452097D5B7AA5B2CAC668D4D075 │ │ │ │ │ 1A0F70683E96AE35A6BA0B59619C215A7012568991AFC0C35789DD0ECE45C649 │ │ │ │ │ F44580845F0FA422868CFCC8029513235C0286B76196E350498845EA934DF289 │ │ │ │ │ 1D0C954B079BD2977384B96D8460B4F50EE635A4C8F7A3B6866F93CA641F3F2C │ │ │ │ │ C93ECCD6BBCD792189A12FC9366BA7134EFD67A22B4FD62465250E0BA6B7C627 │ │ │ │ │ 73E8F50E379328B7FABA341B0D50F9A2CFB055E01DDF6BBCF6FE4114BC36C10B │ │ │ │ │ E581D76A84EA12995506C33DAE9035683FBD5F54AA1545992B94B8ED946E5866 │ │ │ │ │ -2F2CF265A5AE5DF94A417B9C586F6B9C596D5A5CEFE74F770B8779D3CDEACF5E │ │ │ │ │ -4DEC459759D7D3D77E7B60A16227426FF8C81730EEBF03D84CCD2B72602D2A8F │ │ │ │ │ -76384DB473890FA5F27B754832C547717B04A1FC5EBFE112917604D7233B3B9F │ │ │ │ │ -FE133B09AAFC8C60E806F3A2A811EB19B57E9F174F71E74E1BF08845925D5CEE │ │ │ │ │ -D8B32184B962EEFF0432AE8F4ACD5D181C186B6C87AE283E6F3B6399730155B1 │ │ │ │ │ -34BC5A74637D22B4AC24A765F4CB1881306E9D114472DB2D8482D3E70456875D │ │ │ │ │ -74EC2A7E24F94C1B867EA193FADA6F132370A02A7F704404421DBBEEF4D377B0 │ │ │ │ │ -6FD3B44C4B53DF870E932BA700422DD125FC00D210197A2B78C149C9C3BF04A4 │ │ │ │ │ -E3EF6A6176E23204BCFB04D985B1196C831374A8CD31383AFB3C87043C72FA82 │ │ │ │ │ -A1B0ED2BA5E4D5BA203A2AA4BFD55326A66FCCDB12DCBD02B6ED0F28E45EECA8 │ │ │ │ │ -70BEDF7F2909377917D58E976F8283A3B798F7905E325CBCF79DC80AB64453B8 │ │ │ │ │ -5A622A384230B4229D6DE94BA7D1CFAAB8227EB9931552D0098567342D498AEA │ │ │ │ │ -D55F4826ED6ABA190A03260CF4D1B0C4836CE4EAD15879E10551DFD35A8C5E63 │ │ │ │ │ -97F7C2E5B1106EED3746A1716376B43FA6D812C42A0F4E7DC8228619785077D9 │ │ │ │ │ -91391138EA6A07CE358D213C09806D499A88D575358723E331CB230DD4CB1274 │ │ │ │ │ -7BDB660BA3129D27BE899A0764CA6BE06A84B08C9EA649010DAD65570A579F24 │ │ │ │ │ -1F3EB9F89B2155DDAF488C120BBE1D5076E650B4C5654ACB4DC2C72ED33769F8 │ │ │ │ │ -ED6B343D0711FB967996E7A9565B70A4C034294C82806EDD634136CE03248079 │ │ │ │ │ -1DA779C965AD668C8C5FFCBD07A47E02070040A5885DF629FFD3A7E76D5F0C5F │ │ │ │ │ -2CEDB17238D3BFED9D1DB31CB9CEDB14F488C11E77C09253269740FCDAF11B12 │ │ │ │ │ -37C2003DFA53FFDC79D40C2E8E322EC1710730E2B749997151153ADC3D84A664 │ │ │ │ │ -1EC17E36BB7B12A561BDA48A0DA8C0DFE404FE6CDAFD4F029BD7155EE13414C9 │ │ │ │ │ -E77978EABFA5EF382FBA7741E7400BA69C3EF9FDDA646368CCD60E418070BC11 │ │ │ │ │ -A9F865BD30F2E22B2F53BD74582673399D3FAB6113312B03780F7EE1702DDB25 │ │ │ │ │ -37D4785A32E8D2D5F665B40E565097DFD790FD0960E8D2722D7F38B3A263F5C9 │ │ │ │ │ -7BA8936194BE4AA0B283C1906516FE0D755D6A0173BBA7AB9E6D3883BABDD133 │ │ │ │ │ -7BE7ED0FA0F4FB727A620510F949BF803B4E437D659D84EF7EADA0E0F98ACFB0 │ │ │ │ │ -23EC11EC8AD9147321018AEC6C27CE1E3712876A561171185D4FF63DE2D7B2D5 │ │ │ │ │ -F3333FC6A3539581FBDF7923F55278018A33DF97EF0D286884B3438BEDC7FAAB │ │ │ │ │ -2B6EAE8EDE4AF19E342E68BC5B7F0643ECD2147DC0E1539DCA25CC54DA352FDE │ │ │ │ │ -95B7AF3D5C79475788AEAAF2BD157813250ED5F55283E05E5CB9B69860AAE794 │ │ │ │ │ -AD9E320B8DB2881CCBADD5965B5B288416A387A8A88760A2C7426BB89349BF33 │ │ │ │ │ -4FDB0DC8BF112B0B2CB9A6F3841E9E593FCB707E2F028747982A5FB195EF266B │ │ │ │ │ -7F2AEDFC0E767ED18B8EEAB954875F0267704201145640AFB8420850AA9235A0 │ │ │ │ │ -EF0272AE634BE30FFCB2F1571DDAD56D27995F089344812DDC3BFCCE9A01864C │ │ │ │ │ -63044BB523CA08700936EF6932B1C53EA335488D61254C0EF6D9C25D838EDDE8 │ │ │ │ │ -4316C95B5508BC61B1D369362B08D05920869D132B88959618BD984D1023B3B0 │ │ │ │ │ -C84C6E0DEBF5E6A098D2D311933A12001BF2FFD5A4F9AD8E217C8ABCFBC522CB │ │ │ │ │ -E13102FFB279D87610D814F60BDEA418B3B3FAE6453725F248EBF5FD68F64901 │ │ │ │ │ -D15C8E327123D29A55D5CA83C7A291F5E3019D2D0E095ACF890FBDB7F6BF8460 │ │ │ │ │ -BF9A9488E976136A2AC52525DCB8E44DB900488B6CDBDAA3829F5BDE69176836 │ │ │ │ │ -C5C71CF8565AF3BD0ED82F838A55077499788C700A83F2CAD4F35E6B9DA81312 │ │ │ │ │ -EC157F25C1D4E790A25847FB6CD293CC06CCB16D834E13265BD7CD20DE7207D9 │ │ │ │ │ -BF52A74990302548BA72D43CFDB777BA7AE47F8E351DF0BE90C9BEC35E00ADE0 │ │ │ │ │ -A1232A9D0DCADA6F67A5A3341D5C972EE00D5D6DCDDE1A1575F21C448A60A121 │ │ │ │ │ -06D6596F9284C631F2C48300F81FA31860433C352D0670D32A09FA73E500B7D5 │ │ │ │ │ -E41237559AE128F3FEBA253011ED5F3C30DA9EEADCCC7731DB92A4390D0563CE │ │ │ │ │ -889C140822708F8331581F35B8301155A05B7A294DF227BF405B29410A16475E │ │ │ │ │ -2D0908B24B5F6B1049924010D3BB54C576CEB45F40E39BDAA7E4B3DB9AFBC200 │ │ │ │ │ -D0081D91A46948CB6546B5EA00496E270A458BE31BAE6DC7BF38B172DCE37998 │ │ │ │ │ -CF066BB12DD8F5A7C3D0ABAA3D09B9D0D4B3BE63C878C4298653CAC15BF5F5C2 │ │ │ │ │ -B1D15E3E633AE79E888E653393ED59A7CDA7E9068930FAA8AE92998BBA540761 │ │ │ │ │ -103E550604B354920C878D864A3BAB1BCD5F7FBC20299D9378090E322127FEE4 │ │ │ │ │ -6FBADD5DC676C4E43A770ACB32C741B09584C42DD34144A2E166E155CF464826 │ │ │ │ │ -4839E2AF6FFC16FA35FD220CA4D38775ABF5D451AD6176A2D95879AFC52DEC34 │ │ │ │ │ -6E8E08F54C38050B84AD8642CF8E5294931D6BDE24C37281681860407FBD3E70 │ │ │ │ │ -B5FC85E4BA85B4906C52B7D8C00F873DF35F6029D02E0CB48BF022AC1D43A384 │ │ │ │ │ -9127ED4095CDA488F0DF47E2704CDECD955730D905F1032D7E030D2713B61692 │ │ │ │ │ -B27C7109E91AB36BA511E3D1C5746B1E3E8D4DB9945807A09703B2A7AC46C46E │ │ │ │ │ -7B37695A8C66D16DD2C0267408019073060F5297D914DC82EE366A18EE83DDC4 │ │ │ │ │ -D7336DB4C55BF5E954B9A9EAC32EF4CBA0EFF1F707727C0E8FE66A03C4E907A8 │ │ │ │ │ -F2FCEEFA8C1FFE9F049DC19D310E499F4E93426A30BEA49DAC7DA3DEBC8FD5C6 │ │ │ │ │ -772FA5A0349608F13363CBDEC878CBB7B9CA430F6EF6D224B061DEF0A04E85CE │ │ │ │ │ -324615281554C8542B9D7CB36EE653D9DA2A7A22304CC9D5591310C225C8658F │ │ │ │ │ -61734D6C166D82D40E3C9101CEE5CCD36E035E3A456A2CA3D86C3848BE71AC6D │ │ │ │ │ -66BA097151892454C1B54DCAA8446CB4D2560596FEA1B5E27A33AB5048505F1C │ │ │ │ │ -1D1EC90874FFDC51BF87919E8A32BF9B35EA77BB194F7BC56D787365A9A0ECAA │ │ │ │ │ -A3AE31D0F7094384D711C1C32B7BCF23AA2B9829D824DE6630E9CD41CFDA257C │ │ │ │ │ -35B647D814157B3A74E2DDA789728B53481DB60B8123E4506672996A2504D18C │ │ │ │ │ -BA6D944C1A52F609030AE11BBADA74BFADE0E3863F8381A5FE62E86563D28A3D │ │ │ │ │ -7FA969D35D9F4FA55666BE6C07328C5EF60F2C1E721ECAC1E6E940C848DC983E │ │ │ │ │ -27137FEB19F49E42C32980D55D02353954C3B139EEBA7ED630949D8FB2284151 │ │ │ │ │ -23301AB2961A680FE6E0A5F0144BB2D9833E00675A61252597AADF19A579FBE2 │ │ │ │ │ -E6FF7D47A529B4B8086FF3E835329AE96EECA335CB645E6CD5E490584E56D560 │ │ │ │ │ -94AB43D0E955B26CA29D1B0C0173DCC0DEBC91415C7AF346B28B604FFF2B9771 │ │ │ │ │ -1FC683548B604EC447C58633560A03120539AF745E6D234BA7B209D1C561F2FB │ │ │ │ │ -5F27DE5A2D8B4A4343424C4CDEB47BC2DC8DDF32C795071FD55C0F7C4EFE1F57 │ │ │ │ │ -1A7E9BCC361B46E97F738E7283B09B547EF4F8B3998179CF2CA4B5EDA2618657 │ │ │ │ │ -2598D05844A7F3ED9BB4FFAA32C007E388174FE93BB303A41DFCD08F9C2E09E2 │ │ │ │ │ -537DBA88C37EB1106628D609485147C46F55F57AAD52568E34B5F8E9CE7C771F │ │ │ │ │ -7D193F7FDF05527C9802ACE4B23C6BD2A0DBB9E7E299FF26625F1D144FCFA5A6 │ │ │ │ │ -4AD38B39C3F1894AF02E5D95427209AE35477674283EA4A4A87374A95DC81FAC │ │ │ │ │ -65AAFE648B86315D321009F8A24A43A7C759BE666473BC7907EDAB5629D650B6 │ │ │ │ │ -464DCEBA2BEFB4E36655C2842F5C7FCE1ECD3CADC0685E6D77DC5795CDBE32CD │ │ │ │ │ -73D76649494AFEA2D71FB605FBAF83017B35CF59278E6E731F989EABC2770338 │ │ │ │ │ -F81393FF36A8219F90958FCDE184058FD43DB38A3119482F6DBAC2F23941484A │ │ │ │ │ -C63FB4FA4DA5BE56BBE0D8BE33596CB276BF2A9CFDDA3297AB5D56092E2C18E0 │ │ │ │ │ -1AE249F2AC6A8876DC328FA1E3F724E40742E7905E3E946516E48054D4CE98AD │ │ │ │ │ -1375ACD8A381B8C6AB3C7B409E300E39CBB0317EAC086F79C877C075392A8951 │ │ │ │ │ -3D6E7435037953A281327C65F65E98B869DE6B1541DBDBEA49A5C2CF9F2F3F8C │ │ │ │ │ -9E783AB18B6AA1001C955C907003A07AF991AF857D03EB7160746D4CB7BF76D7 │ │ │ │ │ -D62C8A67D805C7F4829324D68174D737390F1B2F4DA417B2CC98F252A33A1C1A │ │ │ │ │ -2C7760718F90B85F65987263D2E86DF1BEFF048B8B58478F8775E53C272A00DF │ │ │ │ │ -C2A8D054270AEB1DDA01EA3308435FA1FD76168046D3463FBDD8CF2729A0E5F6 │ │ │ │ │ -8D599A288251D211395450C1B9C3DA5E7A22A0BFCC302FF1EF41FFE6113DA942 │ │ │ │ │ -EC757F7C8383E073CBFDAA42B421D079F3741B29C67644A9B9EC8EA730DAE7D0 │ │ │ │ │ -1F9D212360584D9AF83F808288A162C6FCED6D27851B6824483DED4770ECDD6F │ │ │ │ │ -6E97B47ED4B586888E349A17B7AC9061230EEB323027B542DD897F84CDFB0E44 │ │ │ │ │ -8CC52811E1DB305D79A151ECBBE2E48D3DE4D672A102A16EB85571DC890490C4 │ │ │ │ │ -3976AFFB9EE06D601B76DE445CA6B4B92DFECEC212A520DF5289112C74C26C9D │ │ │ │ │ -F66371F95BD75F93AE040DD0A0FD63C444632868EDC39C90DC6C376556E459F8 │ │ │ │ │ -2D3F413FF168A630D6E07E1C063343ED04ECCDF8452F4657739FF10B305CE25F │ │ │ │ │ -54A39DDAB43E9A7B612418CCDAC590DA0CB939BEDAB6D7DAA3EC8A7C58EC718C │ │ │ │ │ -11999E4CA3216DEFE2A6D56C53138F60184A75A3DF321670048D4015A575A411 │ │ │ │ │ -A1FD9827506DAFEE57DA1A3900E027B6EFDFF96C220B6955CF9EBC18EE42D2C3 │ │ │ │ │ -44599257691096B15923F3F94FF7AE16600E0F1F96E4C7A9B56A09C125056862 │ │ │ │ │ -29563B592D493233BFDF4DE32107709A4893035FD1D0F0A9B88AA26C2924C888 │ │ │ │ │ -7F87D44F4D6569A3CA22418791206C68126177D35FA6D5E5946D46035A0FB946 │ │ │ │ │ -331D6D1BE3BC04C2BB6B07D438343E236869175728F5977BE8D7936987A9B1B9 │ │ │ │ │ -B0085D0E0EF532BAF535FA30DFE25C5480E10174EBF5F28CAB7EFE745603FF48 │ │ │ │ │ -E613DDF164B551C7BCFBDBEB014DEADD3F1730E56C4F5F27AC297DCF6755D70C │ │ │ │ │ -FF7202CCE294A590AC658877CFD676574152E37CF0AADA8A0689C382E2CA9E9F │ │ │ │ │ -B16C548CEF178016926D8CD24E7C20E5AC055F5158F421692C3FD017C97A1717 │ │ │ │ │ -6107FC3917B47EA2248E3DF7EB2D745DE7E799F6B95C60828E6A66041E7B1629 │ │ │ │ │ -B3CFAD90B5DA7AD3746D225BE2E7C5C3275814D41D87E77BB39B1C130BF12A45 │ │ │ │ │ -C414DD14F045464506483347E0132A06502775335276C02A0ED2979F65DEB81B │ │ │ │ │ -82C8D4D0BBBF0C0A45B6CFC5F532F9F65188D6FB88D02206D50571DDAFEF8667 │ │ │ │ │ -03E49130B05D592A98319F3437AF1260E644A5347D6E93B0514FEB84368A0997 │ │ │ │ │ -3B2D7E084BA373AB3A99653A8A58E0BF710473C36D3FEC5B67AF94EA09AF7225 │ │ │ │ │ -6F4012E73DE644D3F74A9CBD9BAF987CFF035E58797F6E318745778D26C67EA5 │ │ │ │ │ -DBDFE5B07C93727A2C842C5B8572F015E4F363DD8C89B9B30311FF4FBE5949DA │ │ │ │ │ -C94750B9E46EA1D954F1DCFFE9E77B04F01F66E50B52DEE6BAE8282FD239A4B5 │ │ │ │ │ -805639374448CAACE8FF3A5A0BA69B9D736E3168A2562B9E3ACA3B7C60D9B9C9 │ │ │ │ │ - │ │ │ │ │ +2F2CF265A70B9A80DA0210449E4ADE783BEDAC1D66E351E0EE272BC22A49E907 │ │ │ │ │ +5280062A516E9368A5EBE8270DDF9043926E60187AEF5B99676B92B7645170A6 │ │ │ │ │ +A66F3B005CC7D780BE326B4DF72248F67C45B5297A869FE7C7FAAB687F71B291 │ │ │ │ │ +96DEBAA700EA1182F55C83196C96384ABAF02BB0814BF44092DDBB08D7D9CE60 │ │ │ │ │ +D206B93A9858EDC038C9BD9DD6534812BE7FB3A95A5445B5800D0B31E275A358 │ │ │ │ │ +2DFCD77FF6AB80F078B99E6767AE76AC32D1E34E339E948222F23A213549443E │ │ │ │ │ +171C71683C4EDC4E8092EB6C07E7D7642C9CD8D51FEABF3E42A0A061FB60C5F5 │ │ │ │ │ +F06E3DD6FC0D4F3AB7A75674B7B22AB60C26069BAE6567BF155CBF06B49099A0 │ │ │ │ │ +978BFAF1395943E4244DDA1FAA590BB814432AEF45819A23128D8BE0C4F1631F │ │ │ │ │ +831972EB6C8B045A9C1FDFEEB1CE76A736F627EA740C0BB1A269A14BD3BDCB27 │ │ │ │ │ +57BC57A8F763B46BD72DB0617A5DE674CE9D5034FC81E531BB9CBB8FD51F8D09 │ │ │ │ │ +39ABD7D04CDBF5BB7D73886C19508C1653ABFEA893A6ABB9D21DF6E1FAB7B0DE │ │ │ │ │ +1C04FEBCC9AAA5E4164F60AFF65D5F4E2B0E381DF0A87752C489EBED6D956326 │ │ │ │ │ +80E78B73753037BB487D885DBE48E9BA965DF3D79BA6111FEF592B2C3FF715E9 │ │ │ │ │ +F5665AFEE9C684E2C80951B297FF1E4498AC340C023E3A3A4643C0D601762CAD │ │ │ │ │ +63888B83A7F2837EFB65DA8AA7A8C5E623897B44427B8F7BF5294AAAB9209720 │ │ │ │ │ +1268C94A9ED539CF789D44D262F849A49FA3C90D23942D63408D2B04178566A6 │ │ │ │ │ +83B91D2E9052A928019495DDD08DDFECF5E8778FB1F0A43C45A8543703148C91 │ │ │ │ │ +83C91971AB72FD76324126CE2440DA7466BC820F50B9A86F873AD492D3E9F1CB │ │ │ │ │ +0E00060ACCFF853606E8CEB4B673E13142F686CBC4FAAA39C1B46F16B60DCFD1 │ │ │ │ │ +A07028228DD3BC23495DCDCBEF23B492F11A70DD74A6936FC9DC7551A0B9BD4F │ │ │ │ │ +152E59CFD7EACCD18DC3EF4D60730D930D6CA29C757530E63034E8648BEC74CA │ │ │ │ │ +D5D059A51FD0ED3DEAD011C475F1F2AD3235FB70893A5348B6DD592989ED87A1 │ │ │ │ │ +BE0C1EB9314A169BFCF74789A64886CFE5818D89D3C42921F039F0D73556AD0C │ │ │ │ │ +CB80AF216410E600EF6B97D6DA4C1129FB615584902D1304D42AAC73A6FFC59A │ │ │ │ │ +4FB4965F14121FA2520C1483894693907679A1A8097008EDA0684AF037F8B4FB │ │ │ │ │ +072AB65E4C666510583C8C434181CADDBCBEE5C1105A672359A95DF37B8770FE │ │ │ │ │ +850567DA30750F0CF540BB459E4C130EC873E3AC2EB76A5C5293F8853AED1E94 │ │ │ │ │ +45571EE22F93E5990A69819C7C7C815177A323CE436F18B29A83C5DB8296527C │ │ │ │ │ +603B165BC5F1D6D749488E4F5A85D0A0F4F5E619ADCE8E9775E35C23DA363D40 │ │ │ │ │ +E4D47D69808AFCDA00326AD1853741F04C6F62E680919FE2DA2C70DB2DEFA5D2 │ │ │ │ │ +1DEBE09FCE185FC6CBE5FC83358B6A0249A14D5CEAC63C3F857A652020775EC8 │ │ │ │ │ +668218A1D75B8515B5B8743ECF4B628D4CA626179E8D1F02529BE62B8710E802 │ │ │ │ │ +FA1D42C3BEB057682AE2A43BAE72EA8F1C7FEC5D091A7CB8E7141C3696265618 │ │ │ │ │ +818B900666C992AE6F3AE6D50ADB808CF27BD0BA23C9155B123171A69B2D429D │ │ │ │ │ +A7E51B052CBCFC74E0EE46DB97C4656245BA07916B80A6744A2E38A4C072923E │ │ │ │ │ +28243FFDDDA944AE7277E1C0572F9A5E3550D1FF6964F3017CF11F3FCD69D19C │ │ │ │ │ +354835A6EC3912176E5C85256C4AB52F51C1DC7DDC7B8FDAA84ACA69D7324633 │ │ │ │ │ +7B7868993A79C99020F2745B5C87ED586EE6E80696B6894D7EB348613C49EDFA │ │ │ │ │ +F26145F568D86049C5AEA430ED9167C6D35E59E41F029B5F10888C0FB114A5EF │ │ │ │ │ +5F29CAC4D1673902EE4E28472CE5AA74AA1C47CEA423AAE3CC270FFB883DA09C │ │ │ │ │ +4CA3DE0BA1FA68259F135FFF5665F5051A98B90D2653305D9F2637AA057EF8EB │ │ │ │ │ +353851CF31D21D3052C9D11612BB1B578E6051D73F74C2DA01A735E232CF5C3E │ │ │ │ │ +1484CD7086E2E9297E0932844B7D18C4CD633E55420BCCC61855C0479A689608 │ │ │ │ │ +D86170439B2580A1D2F1ACD07B648C54EEC399E524A8A84386AF124086A107A6 │ │ │ │ │ +9B91EE708FE0084606CFA2AAE6AE0D69FA39197E6C0074F40200386D427EEC3D │ │ │ │ │ +D5101DF5C855424DF57B28A1DD29D10C7B2B45C973988111EBCACA53189B2634 │ │ │ │ │ +9C8760DB28DDAFB0D2B900E8A81973D430745C207722E014F3BCD411B39DE7C7 │ │ │ │ │ +D90B4FC165F502B0ED3280678A10E0DB6189F9B125181CEB6308C01CA5C8AF92 │ │ │ │ │ +56D76C4144C85F7353A3BFD3600EA5583CAAE7400921D6B72C0C60A73EBFF48A │ │ │ │ │ +152E164070F0F2D277792C64EF20549C4CB12092150A0C33F3F645CCBA472E5A │ │ │ │ │ +31711FB290DC77C7F0C642EB33E8BD1CB2B065E224D2A469299A1B9C1EAC6BDB │ │ │ │ │ +0766672275AC1AE48F9FC2C35D851E2A3D5C73811931548713D8B06C9CA46331 │ │ │ │ │ +A51933BAEE54FDF323E01E15A1329D7D1230CF877492F1CE2266DB4B8CE570ED │ │ │ │ │ +460E701AC24CE4DBF541AFA8973AACC0D254B5526451561C2C2C81014C706463 │ │ │ │ │ +BBE8C9E1320A637775D6F71A7692727528B2C1D7D6E47F04A855A8352635E787 │ │ │ │ │ +3B99E647A82E294FC229CF656AE5D8DB4AFB6899F362417597A871DD11FA1D78 │ │ │ │ │ +773AAA6C1479FAAC9896206EB67DCD871AE115C8DFCC6BE691B3373AEF5F6FBE │ │ │ │ │ +F8D07E207DD451D383EBC67CAEC7244EE138DF87533459B4BFF0104341D4B366 │ │ │ │ │ +6519E245183232D53800CD804F1C3940F8736FFF371FD348096FC5D393C15373 │ │ │ │ │ +817019873DC14EFC3152511FB4D3D55831AAB369B447FE56A7D9F297CFC0D56B │ │ │ │ │ +41F223A4F5C36C9C0966DA8EE0BE89FA3663504F7D41D908769721B1D7ADF9BD │ │ │ │ │ +F925921F7374A93F3FCD23C9752BFA972078FAB4497ED49F9B706DD774559308 │ │ │ │ │ +20E1DDE1C1F0E86CB381323D79EC7DAAC296B605F3BF04B0BF26F376439E8FF8 │ │ │ │ │ +43C07C1FA81D8758F3F65C92BB709DA0CB5A411D7CB546DBF3E65C109B9E24F9 │ │ │ │ │ +687C15ADF35B869BB210E4ED7BAA2649C4B8F6F4A7592A9002B7B2A722559D1C │ │ │ │ │ +FFD487232EC995E1CA0B264692A0FF590CC201A1AA7FFF07D5E9F20DDE63A225 │ │ │ │ │ +B92EF6D3DDF3B4C1D56EDC7E11A840CFC2FF7515234E5867054CF54CFBFF1CF0 │ │ │ │ │ +7FA63BF680840ABE6BD0B000A0E1C160FA3055094BA2BCDBDDFA8F810A5AA125 │ │ │ │ │ +53B214FC3553F11ADF3B5A3675DB94E87E415FD63D66AF62A218CE0B2C334F47 │ │ │ │ │ +01DED135B11A6DB9A13B89EDDC137AC4E0D9955001433FE00D93F229189CB54A │ │ │ │ │ +422A017C938532B2C7D693D492382851F0C92E593C816EEBCCA22917E25DD85F │ │ │ │ │ +D53D31FD97E831DDB07E1B1BB964DF0BAE7889A25659B4CA41B4DF6F445BFBB8 │ │ │ │ │ +670F79A2945941BEA1C531E36E88DA34BD92F4CBB3DB5B8843A82C668B32D8AC │ │ │ │ │ +486EB11BAD69293D9E69FCED9879155B9147772A730233902B8CDC9FDBD0AE87 │ │ │ │ │ +BA08A722BF9A97E7B4A16FA49B96499D3A51CAF120AD076E8C66C7096F7ACDF5 │ │ │ │ │ +2B4D5A6EA73D82F91310298438A17968F57C4B5423D53C6CA63FBF3B6389AF85 │ │ │ │ │ +448D7503F11D67C59E8A4851D7FA36A5CBE5D7B1C0D5E731E523923BD7FAB779 │ │ │ │ │ +BCA4C90704C4363746D71BBDE10DA15DDD87801D175F4E1A80C37966AA35E82B │ │ │ │ │ +A8858860352F49F1BF63F6DC9AE8BAA6822EBE59AF7CAA4CD400026BD9670C2C │ │ │ │ │ +B8CD4960DFC30817399D18D3B29A33D5871384640D1A5806E8CE020CC2DBE5A9 │ │ │ │ │ +01CBE020FE09318E4E8798B06B842E61196CD832019322F481867293C4052424 │ │ │ │ │ +46465E585209D6853BE39AC9AE2E1CE3EF6DFE2ECCD09BCBFAA9A695DB486241 │ │ │ │ │ +90A300F63D3DC9808A34FF526652A3071A66CEF0716927A835AF2531ECAF19F0 │ │ │ │ │ +F8F7D497C89BC3F2A722D217593E75344638A4C23660638AA0CC89FA387F5789 │ │ │ │ │ +6627E5D94C5C50D15EBE109718C383DF6F220F656FC0619443197FA3B4B4FA9C │ │ │ │ │ +7160BB56399420E29845DF37892DBAFE24DF9ED3A343FBBEB749CBFB0232F8BC │ │ │ │ │ +E51E050E7413B225262EC1BEB6B60BBFCB3E6D78B59C8CB97DA53E21FDC1B6CE │ │ │ │ │ +DBFF270D20814E374344D95130AD58BAA52606FE810160A5656AE18670DAA3BC │ │ │ │ │ +2F962A029A40D59FBAACEF5620A77781EF50D388E8C4E3F36617E10D9C343DA2 │ │ │ │ │ +A361460FD16F67E6D9FBCCB675F09DBA0388AD80D08E0223C152D88A2D5B2011 │ │ │ │ │ +A3D93CD8B0771FBCAEC6BE8B0B243EFD26D3F41EA651FF88EE4A5B8A60558C95 │ │ │ │ │ +478071549DED5CBAF3AAA6D6A57E64A14A682E50931550001E3F890AFC76CC69 │ │ │ │ │ +9AAD807A6AC633127087D7ECD9D35DCA95ACE67DE3B3CCDF52AFC6AA3AA9CF12 │ │ │ │ │ +00E5234DE9DA753BE947D67A87DB8F6DD8B9097D77F366474998864DE27DC377 │ │ │ │ │ +3B6A8D9FD789BDE26CA577AC97B1FF959413A2639DEA97EE9A9D4FEF2E8C745F │ │ │ │ │ +6609B6BDB3CF8BE73B49D3887A8713592E2AFFE5BBC68D26E11E168026CE254F │ │ │ │ │ +0231C9A49B85F1EA5F4284F6529A56EA6B219357060DF1F244077877644BE4A8 │ │ │ │ │ +AEB577D97DDB347094B23A68CE24F99D30CDB9C4BDB00DC62B5AA46380A067F6 │ │ │ │ │ +1DC50CA073D4CCFB4626CEAD905A04229A732ECF6A7C24DBE0775C382B646E36 │ │ │ │ │ +169A81A079137FB5405097AFDF29880E0A13D82281831C15E94DE4DC085394D8 │ │ │ │ │ +60562BC39DACFB3810585BFD8C064C5B209CDD9F86B35442079B0F5A6D04E63A │ │ │ │ │ +51AB0C811C35C9FA5921773E50776C09A422FAF53941DBE36603B53F1352A312 │ │ │ │ │ +E2C83A061174750604D641C327CD3B8202797F7116DC1EF10888C6AF1AED1FD5 │ │ │ │ │ +93B342803C2FF710A78B200D6FDFD0833B709E603F802F0021350B24D9895EEF │ │ │ │ │ +39CD15E66522843CFB6928902469C05C1F01262E42E9906372796DAF52819152 │ │ │ │ │ +3CEB3102D23AA0CED94C9677C6607F0EB17DDA7E2F08D3A22C51B25CA62650CB │ │ │ │ │ +1E4A2A87DBA2E1D04434306C1ADABF17B144A1D1C7C7FA41AB19E26119497580 │ │ │ │ │ +C38B540072F9DCC481A43CC9 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ @@ -6750,23 +6733,21 @@ │ │ │ │ │ /UnderlinePosition -100 def │ │ │ │ │ /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 49 /one put │ │ │ │ │ dup 50 /two put │ │ │ │ │ -dup 52 /four put │ │ │ │ │ -dup 55 /seven put │ │ │ │ │ +dup 53 /five put │ │ │ │ │ dup 65 /A put │ │ │ │ │ dup 66 /B put │ │ │ │ │ dup 67 /C put │ │ │ │ │ dup 71 /G put │ │ │ │ │ -dup 77 /M put │ │ │ │ │ +dup 74 /J put │ │ │ │ │ dup 83 /S put │ │ │ │ │ dup 97 /a put │ │ │ │ │ dup 99 /c put │ │ │ │ │ dup 100 /d put │ │ │ │ │ dup 101 /e put │ │ │ │ │ dup 102 /f put │ │ │ │ │ dup 103 /g put │ │ │ │ │ @@ -6777,15 +6758,14 @@ │ │ │ │ │ dup 111 /o put │ │ │ │ │ dup 112 /p put │ │ │ │ │ dup 114 /r put │ │ │ │ │ dup 115 /s put │ │ │ │ │ dup 116 /t put │ │ │ │ │ dup 117 /u put │ │ │ │ │ dup 118 /v put │ │ │ │ │ -dup 121 /y put │ │ │ │ │ readonly def │ │ │ │ │ currentdict end │ │ │ │ │ currentfile eexec │ │ │ │ │ D9D66F633B846AB284BCF8B0411B772DE5CE3DD325E55798292D7BD972BD75FA │ │ │ │ │ 0E079529AF9C82DF72F64195C9C210DCE34528F540DA1FFD7BEBB9B40787BA93 │ │ │ │ │ 51BBFB7CFC5F9152D1E5BB0AD8D016C6CFA4EB41B3C51D091C2D5440E67CFD71 │ │ │ │ │ 7C56816B03B901BF4A25A07175380E50A213F877C44778B3C5AADBCC86D6E551 │ │ │ │ │ @@ -6959,178 +6939,161 @@ │ │ │ │ │ 82032FBD2FCB6E403D34B85ED4053A8CB619BDD4DE001F4C3007B1F317579651 │ │ │ │ │ E6D6662189CC2D95AB85D7473F65C5D7B4AC63B0FE928F3400035D5A9D443D0D │ │ │ │ │ F3532B99F3AC26CB25EA3CD64C341159061E02EFBC7C033C05CD919BBD827A6A │ │ │ │ │ BFCF3BD739E32E7FE909AEE068D50FAC33605FFF98C7D0115FB860178FD03DB9 │ │ │ │ │ 7985B78E0AC21F2EA065FA841F5928FB85163B2E2D8F850DC7EE313912C45C28 │ │ │ │ │ 2783F6762C67882EFEDDC7E7567F91C16B16FD8D5A1ABF35B5586307701B91AD │ │ │ │ │ 54984598F2AD46FEE3D68A2731BEAA754C8E730FE0E84952EF77930E4118F8D7 │ │ │ │ │ -2F3AD7547ECD7EB31108291A22BBC656F4D968DF891E4F87EF8FFE711A48FFD9 │ │ │ │ │ -94762E9918C42251D75772AC97BC15A4FF63D911D96AADA1CFAACE8D7001935C │ │ │ │ │ -9D7A0E6B35E1522780C2629D74057738FCE1BD41CD81D97BFD99D19FE03B2EFF │ │ │ │ │ -7B80B18DA5538D06A810DD315F31DE1331EDB82DAC760E6D8A855FCA3C8DD9E3 │ │ │ │ │ -61164D1386FCA2A0E7735AD69D7D9C6335F02064419B2296ADA17DC51A1E2195 │ │ │ │ │ -45FA3A158E075213ACD6607B07385F0D9F5F3C5C385624B43B10016D497FA569 │ │ │ │ │ -103C0A7CC701BF1558C587B15A8094D8E4524D74DC263BE9C5D1C96970A7324F │ │ │ │ │ -5514ED0576D79D5A7C8CC2859C832B0C5869166DA1DB8CAC589AC9EB48379CBB │ │ │ │ │ -33B840FDDADDDA5FFFC54678E901A33854A703C01C16945C99655BF1BEA74EDA │ │ │ │ │ -723B5FC176D9693ACA831C563CDB35C96C69575A510E33D5BB62701CDD2A759E │ │ │ │ │ -79C045541F511340C52E888907801E3548CEC3D2BC22BA40337B64A862929ECD │ │ │ │ │ -6D7C3F92B5C9AC4427AA6986DDB6A4A792F5FB6C969F50C5068CB2A5C9205191 │ │ │ │ │ -C19B22A4D9627E0304444D963FE2F3C6FE86818FF3A6B50130BCE2DF5DAE000D │ │ │ │ │ -658D411135E9DFB829BCF033FF4ABF1A3F3E6579537DB4D17EA4BF7F2F6ACA4D │ │ │ │ │ -6FA0858A09BDD229CF49A29030D280273CEACB3E72945F424D8AAF50E53187D0 │ │ │ │ │ -61786DA0263FE776D86CC33DF81D8C0325343665F9E6096EA072CD7F53C9FDA8 │ │ │ │ │ -74C647B762ABD1B70F4315247C13EAA98B41F80E9A3E62DC60C8FA85254E5239 │ │ │ │ │ -6F9D3EB9C81F9A4EB912388D4F56D56ECB4179475564C8665CDE38A211E518A0 │ │ │ │ │ -96C3577DF26ECCE018A8C4A547CA4D04E6CFF0CD0F5377FF9D64E584E0A506AB │ │ │ │ │ -C5E8D801F041938BF9F11DB1F8496A26D416A8CA3F96E6E43F149E720F43F1FB │ │ │ │ │ -041E107C8F4752AD70F2FDB90292F314F46D175AB7C9E67CB61C820B36431613 │ │ │ │ │ -D24E877E74EEBD37AF9B2A6D5A0B970F1619FDD5FA8EEA9C6040251136A79F29 │ │ │ │ │ -9900E9D3E27DE70055DED223484D7E8701F0B0AACE6B7C9A56C81A8FD69BE0C7 │ │ │ │ │ -1321229E636B6FC5239806C6A6ADF975BB49922CB8BD33673C5BA58E2BC89BAE │ │ │ │ │ -F112E6D7F072BA8276F0FA9E849DDAC1850485863FF731D8B6A671D7BFF94689 │ │ │ │ │ -48CA38DC9ED526469F0F138B1466AEF50AE0C012F09410C0182EBA14EDA6F88A │ │ │ │ │ -12B41CB89998D82D12D6EE917887E66A0D104BD57605645586B3CB02E82E96A5 │ │ │ │ │ -C68BCFE7B8FB2A1A974AFDAD1A5ABCE8FA322195123B2B756E1C73327A89A40E │ │ │ │ │ -92195C4BC057039D69B23F2D72278379E88BEC6023E21BCDAC6B09BCF3A2C84E │ │ │ │ │ -880B4D0514D8177E0B0303E4168A26F4F546B4C147EC46BE1781BB18036D2D41 │ │ │ │ │ -86167DB95D0E91104F342037ADAC83EB146F08159CDEBA1253A6F4B5D8867F75 │ │ │ │ │ -82C1F357F3F916633F96FCFA5841C4315B6D39A7ED995426C51D691CA70A100E │ │ │ │ │ -4C192AE7D626693EC1D685DBBD74BD1EAFC9D037C4EE8CCEDA8D87F504F8FBDE │ │ │ │ │ -9F9BBD3E102F7D4D45D41C7170FA39FF1AAD80AAB0896548E7FC42ACAF8B8B59 │ │ │ │ │ -181507AC944DF27CFCAF8E8CAD8E158605E1DC0EB6A053D19EB868CBCD651678 │ │ │ │ │ -9C9D8B68BA07BA9DE05043975CE9D45CE6D060EB71F1C1AC6F958487E7C23C20 │ │ │ │ │ -C8FA50CD4A1D90E69CA569BA49D747961619780760CA29B23D7C59B2AC56D44A │ │ │ │ │ -7BABD02E07229779B6620473A84B51C72749DDAC4CAE8447FBD2FF0A1AABE41E │ │ │ │ │ -73BE38353580C97C4290101C70A7A68A3FC6BAD1C687542224F6D0618B20A0D5 │ │ │ │ │ -107766CB76C35F94C0375189D1FCBDF95C0EF63F492B83D349E196BC653F82AB │ │ │ │ │ -5CCA7A454E7307F88377DC1BAC1D094433D1B6FA7A9D219DB131D8D97ED81012 │ │ │ │ │ -101E95FB9C4B80F96D088FA02E4BDDDE98CFC4F7C2CAEC8CE29A1738998170C1 │ │ │ │ │ -9A296F3EE4BAD358C0B7088104D4686AA9C63CF636093D54E2217E9151990367 │ │ │ │ │ -2723D577F4BBF5E48236F05887FD5142811CEF7368BD1A4E871EF0C33C7C1851 │ │ │ │ │ -4AD26A1A8436BB2CAC16B1275D49CE3AC5A71FD9ECCDC78871BF2AEF93444FDA │ │ │ │ │ -5E77FAEFC81256F33DA8CE94213BA2BFB809E747014BE88209DF7084ADD424BC │ │ │ │ │ -79C44C39245AF2B8E9342F4C2817619432C4A9FC056C9E0096EA6E02E118AA0C │ │ │ │ │ -216991069C049FFEE87DD9D29C55923A10B9FA97ADF4CA481E5069674734D996 │ │ │ │ │ -DCE76A8AF3E251C24FD4D203547F51FF9AE9F2388191C7C73E2E15B5570F663B │ │ │ │ │ -B9BD27FE105DE7D74B9C23BEF33F76A8317F8AA6EB4FF9271D191727A33E7437 │ │ │ │ │ -7558FBDC1A504359EDC9F65CEADA45790C14149102D03CF36A1B70A7107C1C38 │ │ │ │ │ -2D38407838C31C3A68C2890C63BD5B3D1C77C7E22C275CA9ECBD293743D80992 │ │ │ │ │ -4245782D2D514E2901DD3A8A71E523BAE441E57C17180F949B6CF174C7344DF3 │ │ │ │ │ -DB9811847B8E2A6F9EB44424743329EF6B5C44DCFB895C1897C70EFB980614ED │ │ │ │ │ -1B2DAB8E7671A3B20C67788EA13F1E4BEA3DE20F41BC595407ED103F36FD3FE9 │ │ │ │ │ -45BB59F2621B12CAED1138C7E3A1ACDAFEF959F3336056EF07122A9E0D6BF621 │ │ │ │ │ -2C876CE168F8C59E555797DD2CF9E8FB8443D25939A5856FEA3279F274696CA2 │ │ │ │ │ -73E8174896A9145CFFA5A3CCDBF45C7DABC675FE4B6DF848316629CA47359F84 │ │ │ │ │ -C899B6C9A33BFD59304425631592C1C69F567011B68D8FD464100573FABB4D1F │ │ │ │ │ -09B9C5D1BE33D0B18695FB660B356EDA17E25637292DD0CE84B7F38BEFF49DE6 │ │ │ │ │ -4937314994B8A061F167CEE35E6D68D830B954F8BE90D3366EFD5B254ACC8881 │ │ │ │ │ -250396B57F5FAF02F87F5E215F7649E5285A762EECBF8F3285305B4F73BF4D6F │ │ │ │ │ -0FAD5942EE6D71D39DD45233E4C2C8A47B529442A69060167DEF404121A8558A │ │ │ │ │ -6C80990C983BDC9D8F9FC7467AE78D1832973FC6B58C753D970946E8AA433D11 │ │ │ │ │ -B897362AE87D6DCB5532C7106AB9C6EA7FCE6A387AA913DA40F31905AE10C3E9 │ │ │ │ │ -3651942DD974923FA3BFBA70BD070030ED793F70448289120B2D116635E65401 │ │ │ │ │ -A87218E763DC8D758EE0589F61DB53C03BE3352846C251949B8B7F22A70259DB │ │ │ │ │ -1F6E43716D8A2F7BA9CC29ABA053E11A2B3BA11A13DDDF11118DB5B9C2F55517 │ │ │ │ │ -755F1ACC430CD0E39924C803083B96DF213A591771D8B8B978229E1A4D50B3C3 │ │ │ │ │ -4B67E907E87846CAAAD4B2FB84C3FE7E28E9C711D06B4848CEA219B84BB2C53D │ │ │ │ │ -BF6940417C40395E2D739EF985775E7B4851E34156EB93C6A001F32C6A0C2B7E │ │ │ │ │ -6ECD949B5FE6A5E1E27DABBF77C117628EE9F7B4C5E4185257A6750D224183EC │ │ │ │ │ -6E8C9FDFD2C167E6782BB14318504F666C1E66C3E816F4787C96FD0531588465 │ │ │ │ │ -B15DF72840F52B0B88AB893D1A78DF978B7C0821CB05258DF3B1BC59192EBC1F │ │ │ │ │ -528CF7082629106CE8A3CDDE8166E46C9DA33C7AD265C94910A4E16E64CECFDE │ │ │ │ │ -47DC0424A2125D16FD5D922164A074C1835A25D2B01E8D2472A5ED862259C496 │ │ │ │ │ -81EC85735B170CED6A2647AB0BADD6A8A067B671BF8F3F328325C77C970BBB76 │ │ │ │ │ -0860B5BD51ACA644CF47DE65749253EA458CBAAE90522BFBE95A7FBE58CAADD1 │ │ │ │ │ -E680F1C622F40A1C568E659094C0E3956F6BFA516EE90D0ADD3455197FB9CEB8 │ │ │ │ │ -5E79D1A8CD08C07D1EB3A5DC546CBC146A078F2A830C2538A6B128CD0EC716D7 │ │ │ │ │ -77F4DEEFD629D10EAA2123251B602863629B066207270DE83C7D4847193D2A41 │ │ │ │ │ -7A2A2A62C4EDCE8EA99B61F692CEB13A0BD6E917FC01CB268CEC17451BF7951B │ │ │ │ │ -7D442B4B990ED894B05C03FC8B2E501FDAF2BF0797C5693895A9C29EA47162A3 │ │ │ │ │ -9FD7544DECAB241C775F57AAEDAD77E0756258F085F3104547C2F64782F635C6 │ │ │ │ │ -292E13007EF5E09AFA6C1FC51EC9B5647DE77E34AA4563AE74F66271CDDD90DD │ │ │ │ │ -18E9C1CA295D507E5D6E3FFFBB6E5F5BFA74F70121A5807E8E89D606165C728A │ │ │ │ │ -81792E8077D86D3E25539CFC870C7DF49443E5A485D93889A21CF9383DA3AA1C │ │ │ │ │ -FFA9B3C0203FA2BC621301BCFA6A711937C69BA8C66C6597A2EAD62B70DDFDCE │ │ │ │ │ -42BE4F372410F3A48CB6FE8E6DA1790BC3997858A12364573CC1877031AD8095 │ │ │ │ │ -BEA8E26BD91E8998554D96716A637955BE8174989336ABCCA9496154EC1E098A │ │ │ │ │ -88B4D95E148268F1E57598FFD4EE1269934E75E131177B1E7DB5D51B44EC3B32 │ │ │ │ │ -903FD64BF1514EFD091CE2914E7153E22892DD91C3713D3534DE795FD130766D │ │ │ │ │ -F42F71C60F973FD4DA23047AE8F796DEE8ED924CEC4C46DAB766FD2314B5094E │ │ │ │ │ -8A2D69B9F084783C464DC1F761B65F4374B67946F575FAEB863FC15003145D52 │ │ │ │ │ -78D23A49BC78CF003B6C79487FC19D1FBCBB9DF0A8FF3864D91C13EF5445F839 │ │ │ │ │ -F6FE6A594F33357BD6096AD319D2060D69ADA157377CCB7CA85162209BAE1423 │ │ │ │ │ -5BE02E1CAF9A90D1C4FFDD4C78C51B1419176CA336F89880CE4C5B208925F067 │ │ │ │ │ -066CE75EE0CF962A78A383D2524ECA9289DE21245E1E887D91468FD1653A4FCC │ │ │ │ │ -A8B2D0BE4458E38A895CF7EA21F387D9586FACBB89A514F661BD0572670ADE9F │ │ │ │ │ -7903586AC818AB2F8FD8BF3A8B3F32EF8CF573E273D89EBE885352E89B9EF478 │ │ │ │ │ -533C7272D4694D3B0CF14F3381C9D80C5B92A108324B1755FDB015DD5DAF5005 │ │ │ │ │ -9A33C30F5F78CDEEE957F115F71F56E591D6F831B760E31FA1FC8F6E6AA23A78 │ │ │ │ │ -D47AF3C4795C6762C463A73154F480DF4AE3FF31F15E22EA94CB8DEB36289736 │ │ │ │ │ -A41C800BD62EF3FD7F42EF564586CE41A0488BD81A96995421CDE669DA092FC0 │ │ │ │ │ -58B40987487DB22E72D075F52446658744B97098BF29A697DCE79764161B4D5A │ │ │ │ │ -0983BE4B852456ECEC04BCBE9FCDD2557FDFE66E98D7B98808676AC5C9980774 │ │ │ │ │ -EDD19113801B3B0B94AE613FA382F6E49F6B843C6ADF350510C2A669D42C3D71 │ │ │ │ │ -4D6C1525FAAD6884D7B93915B4F36D87B7B4BAAC307957B51BA369A6EBCB1518 │ │ │ │ │ -2FFE1D0995FD18B2AA6942941093D8E125992DE37695E577641C0C094DF5941A │ │ │ │ │ -11368589C2CED90DEAD621EF765C6E338C3987177EB6202BA42798150CF47EAC │ │ │ │ │ -EA82A8522031CA8547761F21452B0E78813B75A5B3DF8D1D9CFA42214C6A0F66 │ │ │ │ │ -1E08ECCE2A7EA32394CBC866E41065DE1F865AC8C7ABC0D5A216A3D3C456DF26 │ │ │ │ │ -C339271936157C51122DB28049F05C650240AB8B6E3A34510049C399A46389A3 │ │ │ │ │ -77CAECD0A1DC5BA7C287E5A043434CEDE86705C2785115D5ACCCC8B1A2AD5C13 │ │ │ │ │ -5AC60A0A23E7BE7E50BBA0B09B110865102514EAC1EA9D6A9AF50787DAE7568B │ │ │ │ │ -3A4AF07C3542647E98A5214B866615946DE7D178984DAC3CA2B1C9309E4BE6DF │ │ │ │ │ -84581F806B3C6714BA9100AA664E9B86F76D00770532A7DC0F30C3538CE3F327 │ │ │ │ │ -1F150FBAE886A37BC23F39CA14DBB02781610CC8C25A086354C17A9FC6AB2D95 │ │ │ │ │ -E22D9F51DAEDF5879A3C7E946F90B8992E45613E82923A8BA987011AF8324DA7 │ │ │ │ │ -FB814671E9B2FFBDED722BC68FC50AE54B53505AA91F41AF10D0E6D9F360A0D3 │ │ │ │ │ -1D76922E4E47AA05E0ADB615043F5072C22E5BC09F994A6CA30FBF8D9EEA269A │ │ │ │ │ -7962D275EABF1DB3F0E54319156A0ABD42630B9CCDD1EC326E90C87F761E5711 │ │ │ │ │ -772D3D3FE718E867FDA253BF154DE7F42DCEC97E31FA856D0FA0C91FB4568A2E │ │ │ │ │ -31E5204E7FD75A41140CA56D067BD2BC78FFE180736B3D8395560081E5A4B9CC │ │ │ │ │ -95C7AB578B987B0BF527D7E2C2E09A8FFA1174C920DADEDDC5107138640BC74C │ │ │ │ │ -39C226B0158D9730D2EA68B2A1202330138E5725DACD5845AA3CFE84E1883FEE │ │ │ │ │ -88C7901EEE012A0A4F474348BEBC3B26779C20F13735CC8DDC3C90D96D263EF7 │ │ │ │ │ -3128C4C4E806F0246878036744A71D9CD0DAF949E0818CE333B5710A2AF50FC7 │ │ │ │ │ -397357A64A616605EEFAA8D878652A4CAF7DCC9339C9BE7DDAC7D3C7FF0D8BA9 │ │ │ │ │ -F96CC4CDF73366FADFFDAB1702E274A1E603114912CBE9405A80EE4EE54DEB31 │ │ │ │ │ -A96F6F0D6EE6A86EED5F590ED001228D6D6DD350439A0DBCB5876A244A057559 │ │ │ │ │ -E61E832B5F4F77B0C348B6AF7E79A410CDA1AFD6EE5FFBCE2619512C8328784A │ │ │ │ │ -04A4FC92957B798541D8E88301957E2EC03BB2A5BDC15256E385D04EAA27A6A6 │ │ │ │ │ -17EB32EEE419C776C083D29B72B23BFC19B9068BA48A5D5472242BBDAD01C9B6 │ │ │ │ │ -46D27E8DE2244572EE943E96A86E2133EE313BFCF532A93A7E41E46848B2EA1D │ │ │ │ │ -A46E88857D3963A9DDBBA1459C845F2D936E34253A7655228C8BA38B7007B4F3 │ │ │ │ │ -82D2E58E6DC6AFFABC2F0E95003CAF2FCFE1688958B5F7E2C23F9F689808AD48 │ │ │ │ │ -9E5E5F9EA68C9A36B9362C9393C4E5B222D4F285F93F6D7B8757C4045BD0BFC3 │ │ │ │ │ -4A7E0EA82E702AD6EA62DB4D2111C6B19B12F6B489027FEA9623ED0A6EE5FE50 │ │ │ │ │ -D9BD68291413E121CE0F2AF6B8E633738E8E2C6242474211F7204F50981EB928 │ │ │ │ │ -B80A7B0F9587B4334C2DEEF3B672B147108EC28499283E9652162019DED92B08 │ │ │ │ │ -45F1888795267A0ED545AF65DEF138E42001BE2CBA4F858AB38B11360363759D │ │ │ │ │ -C68A096B57E3D434348357E6FF0A55C7F2E9164B3B98C9B9CA7E3C6154FF7C19 │ │ │ │ │ -026F198BDDB718E701004FCD5FC050E68D2910DA90FA7816BBEFB9B305CA0C78 │ │ │ │ │ -C5D441F2EDFFBECF1BBA846CA6F0517EB7DCFB2135F739E811CE372ED63D01E9 │ │ │ │ │ -C282A51833A928878DEC6238BDE3CC4B2D58FF129A693D27C55CA1B3FC6A47A6 │ │ │ │ │ -2459A3853B67927527B27EC8EF70A4739E38192E0EA07C3149F62F1B95FE357B │ │ │ │ │ -F6727178FF7D7D68D143A2EAC3B5DB512FBD7E7592220A586F6FBDE635E705FA │ │ │ │ │ -5EB6E501B402801F17A35F447977DBDBD8AAE234853383ED98FFC9D72E99CE0C │ │ │ │ │ -CF26A8BF8EB1246311ACDA68E2F1B970E6DEA3223530002C6ACB84AFDCEBD347 │ │ │ │ │ -CA47E97514391667FDEF15B3AB81902DDF27C35DEBD71F403B6C759843F15588 │ │ │ │ │ -E4ADDCBC2F72A3D0E0BD96B8434C372F2F157056C6F44BB2A7E41B22CDB7FDC0 │ │ │ │ │ -6494F6550B54147A40E21A9908673B7F983704932E482978A147961D5430A7E3 │ │ │ │ │ -FB7C8B6993927DABD5226932DB9A9DBADD382D6F69BED137AE64A09AEBB9F524 │ │ │ │ │ -9150D7480037134E274D8EE94AC69843AAC21A6903BCDAF6D60191467E832AF1 │ │ │ │ │ -84DAAF413067CA1C778E739939E98093831690A68757D3CC477E80DB3CC0CD95 │ │ │ │ │ -C11CDA96E5E12F8BFD2F7001852A1F1CC5CD2A572AA8FB38A0214A25DD0A50A2 │ │ │ │ │ -E15705B18BAA832133E74961828F6024369B8956912DC7982F7465D405EABA02 │ │ │ │ │ -EFF3A16B6A9901389F719960E913B7A30A76C4A59C723C3F9114BF1F3763F0FE │ │ │ │ │ -A8BE7F92003BFB76DA4A33B9710E4503905C276615A62E5FD52B0CF8E6FA198E │ │ │ │ │ -969B5985DBE8E04353CC980B448D17FE786C45CF681119F589D7B0136710D5ED │ │ │ │ │ -E6504CB5F5F90566A9202C688B1E6E064DDC22E4F6A01D4E9B3DE1B48D6E84D2 │ │ │ │ │ -086D492D1F929CEB12CA99E806124F8DD3ADB13813FC75B83F0F30C9D05AC9EB │ │ │ │ │ -642508F38AB19963 │ │ │ │ │ +2F3AD75525E301D173E869C672552C3824E8BDFD208D74EB3389931FE4A65013 │ │ │ │ │ +44B963C2233052C5B2B4DBF324B78ED455310BDC5462CD3A7499638173A4543C │ │ │ │ │ +6D4EFF6B28094DEA99C0C72A83C0BF0F60B473AC77FB4BABD830033E73781FA4 │ │ │ │ │ +EA6F715812349600C93793913F8D5AC338F961CC3181E4D83F0FF93105094E9D │ │ │ │ │ +3DC8C5EE5B05D0960B5093EF36859B8D6DBFE4D07327EDACA18BAAE80C1DE33D │ │ │ │ │ +6A472DCD303B5B19EDB3C84DE6CB429953C8601159E885E8C17CFDEFD230B9AD │ │ │ │ │ +9434ADD33D46D7B130E01A4F32C39CB42FBF15E58E736FD333D872E1745741FE │ │ │ │ │ +A32F76CFF60E1E8388781E1C45DFB395BED3118539DEA52C3248BE07F4BED3FA │ │ │ │ │ +C4639FBFAD8B8455BEDD73697CF94456B87E5874E4728BE10D734588BA1AC259 │ │ │ │ │ +5724246C61245B6D770D43A3EF4C5E6D5BFC44AEFD997B99CDF04F1D5143952B │ │ │ │ │ +1868C8B0C3250E81B78AE365EFB64149E171160475E47B6EC739F00A797CC63B │ │ │ │ │ +883EE801DC22333C13B44D720DE4229F83E1CE24D7E86C882162BCCD6CA0B1AB │ │ │ │ │ +351C6E8AB001C926C768A9016B06EE3F65E1D0D9AADDFC92BDCB1DDD9F6C648F │ │ │ │ │ +38D5B8772B1B7E40DBAE2E0066D01B2C12051723409C7E920752E2F3568DA3EF │ │ │ │ │ +1FEC48A5AB655F5949C82E22A99BDD724D11DB2475531A67FE7FCDB9B6D54476 │ │ │ │ │ +FF31461EF6DB1198E70E7F688E65D76F1BAF092A322EA1CB6D677503A8CF0BC0 │ │ │ │ │ +D0EC8D4AA53B8AF050A8F25D795F66316DB6A19B648AEFF2B92D8C073C5849B9 │ │ │ │ │ +AE22B2C8A2E1C24B16B422B584D07392A039E02FD022B105D45B98BA46CABB73 │ │ │ │ │ +531B7BFA8F8CE45DFE419969BE8380CD2DB29E21B15F4827F604BAD61FAB0E9B │ │ │ │ │ +EC3BF59D02175921D4633D84815C126E3E534AA898DD069DABFCE079C9F18505 │ │ │ │ │ +C2451298AAC3508459B649B06EDB8FCAF59F9D3C82B88BEB4507CB9E9DCC9CDA │ │ │ │ │ +869B3B744C6E655428553D70B02DA2F498276D5B6734E5E982E3508F5C339440 │ │ │ │ │ +EA4F1BFF6E1BD12B1DE3E497B1C7B342988D1F721F65930E13B89476E943797A │ │ │ │ │ +A657DD993C2DF8307BFA0E6749E4CCEA15D796B66FE200E9E1C6950A29CA2376 │ │ │ │ │ +37EB10B32D5FDF8FE7C2125C33E9B9F29DB71089FAE7DA39205C9300D6FFBAE3 │ │ │ │ │ +F2A4854C765EC2027E57B6E1DF597A9671FCD58459A25B5BB32625E5E4B96394 │ │ │ │ │ +ED3F7443473302699705DEF1EB32C3439C0E318286785F74B517AF39DE6DAED6 │ │ │ │ │ +8146BEEB3EB049DA963DB95E85CE423C76429B9C7EEE088B68C39996FA200494 │ │ │ │ │ +10C6388187E59CDF6ED7F482F6B82F9A09E3ED0BD0275785B7D234E369444B4A │ │ │ │ │ +132484404B975CDF4A70D951126D1B13F8298FF0603AE7FD1AF5896C36396F52 │ │ │ │ │ +3C2F8066DBF2204C0837FE176FCF68391A53F712E8684035169457F036045C43 │ │ │ │ │ +424C5E90110C860F89A5E9FD686D6A6C962CFA050C080AB36C46DF6EB196C115 │ │ │ │ │ +0E125B6392EDE8340464D1128AFF2BEA382BBF715A0D6C1C09F2AD1AD2E91846 │ │ │ │ │ +D59CBA7207E6B92E0D8A7DFACE5A9E2701F157491CF050A06010748D6D0F5D04 │ │ │ │ │ +6040F49C8AC06CAD1DFD027542D01B2186FC2C94D2D212C9241E54A4DAD7ACC4 │ │ │ │ │ +BB799CAB7A7F60C723E27D05F7390BB604C982CB89609BDA39E01F76FCA69D02 │ │ │ │ │ +2DDF1D15BA031355A3FDB9C25B5D015CA1BEFAEA5C3CB2CA62A2CC1F5B4A53BC │ │ │ │ │ +BBD60755E78C5B502B2B735A7BEAB0D625692FABEAF2B9E86869D3867F43F0F0 │ │ │ │ │ +147AA88355950ADB0D2CAC4AA2972F6ACD818EFAA7D46C9872139CE64D83575C │ │ │ │ │ +01711E511BD5AD7716603ADDCF2ECF1739AA1BCC235F0E8197A71F8CFA56C302 │ │ │ │ │ +1CC74172A0286A30FC90B77AEDD671C43FA8EF8B6EB085772C9B377A31DBF928 │ │ │ │ │ +25360D3E42B589C83F0292D478B8D232D3C87B17C97A5F4FCA741D7973B44882 │ │ │ │ │ +2E52A2A6F3E5D18AE8FF664CAF74940AF7D817E81E4449F41ADFE47576529552 │ │ │ │ │ +34085AD507938ECC21FD152C9624771C82DF2DB9AED77320CF375FA34FDE5EF8 │ │ │ │ │ +75B710119768A1614DE0F3C99DE96E0938E02B25C123B1D3F4232941A07DBFCA │ │ │ │ │ +D8463A540F4CF8B0104B3A0004C1A158393FEBDAA288A42871DA61D70D18113A │ │ │ │ │ +A9C68D91C215156D756244E9CC9A7C692E0A08E94CB349FB4B7C6B0925895108 │ │ │ │ │ +1CF6C912AD940406285843EB6710EBDB33225E705D2B7D73498CC2DC9AED21B2 │ │ │ │ │ +7C341A0C5C2DACE950DEDFC53AF6C4819ECC59B7144E919570F2E5F06D72DE43 │ │ │ │ │ +9564AD1BF1810BC66B7C8C178D64A576100CBC380D42E309B1B575E7453872AB │ │ │ │ │ +C7719866D27FA69594974EB51BD18157D44BD52030B67BA3B88F965AFADF268B │ │ │ │ │ +5391968C2A1A9182FCB1A1779DCEDC0D881616CCEE15BF9E584B9F989B96EFA7 │ │ │ │ │ +B465C4209B3058A270954C4BB4C532A0C79819A022E697F9638AC23952A96AB7 │ │ │ │ │ +79B9A0DE4B571B832D7A48A65B4C7B04E426FEECDC4E51C3B864B38E43E37255 │ │ │ │ │ +27E4F4F198D9B48A71D3BF35A5DC51034623BB8098FC8DDA295AEC96A0C4771E │ │ │ │ │ +F8C8C30C2EB2E7D304A4AF84EF56C762F8D785BCC0255DCF29FCCECFC9A6B993 │ │ │ │ │ +9C0D8FD79A13976C65C8FCF030372DDB9AA2D236AFA08AB92119AF61BDC34F21 │ │ │ │ │ +4059D583441D5C3F4A835E3743E45F2C778320FB72FD4FB2797BF92FEFB919B0 │ │ │ │ │ +9EB4F8BCE836A2F7ED54C154AC05D4F58944451A86785F311560097E907F27CC │ │ │ │ │ +6F5A4690424949F0E098BCD0B2E063918426381426D01A40243F52B2E2351F75 │ │ │ │ │ +772C4F89290F771403E4675735BD63A3E963B6CF462F97F2D8AD9CE84189B84A │ │ │ │ │ +339700CDCB67725A704086264CC7C60A35042C2D89847F5EE03501741ADF97D9 │ │ │ │ │ +FF62BEE4863D20BEEBFFECE094A121394BBBFD9B45B047965C677166E95D1F62 │ │ │ │ │ +E518466FF1AD684907559229AB9067C947D1D6D10A9279C66E4B58EE76314C10 │ │ │ │ │ +67F5DCE9A5F7FBA53D81A4B98A0D6390375FA9AFC02E02654325ED35A9488016 │ │ │ │ │ +DC83E98E0D416B0D40418085875FAEEF58132A86A63C7F663CB78DF365983655 │ │ │ │ │ +07A5E2008D4D39262150045996E14E1A9B2A5B376E9985D8C7614D15407CDAA0 │ │ │ │ │ +49DB6E1F815BB7A672B652E9C7A966E87C4B56ABB8C39D8D744DB9072D9F4517 │ │ │ │ │ +4C54368F70799696F4088194683164FA6B5CF37C7FBD00FDACFE1236D8A9B0DF │ │ │ │ │ +6BFBA875EC118CE11CDC93BE975E0B5B1165B242E4C7A9263975B9984BF5CEBC │ │ │ │ │ +13F395529085D650751312830A4B4A79E23A5034C3A26BE0EA261C02B13EB645 │ │ │ │ │ +1C5A18306CF4DCD2970A702679D6ABA1E77F1A3402B1BA8D50FBF826045F07B4 │ │ │ │ │ +51A42E2ECB0CA41D32FA75A67DA124C36F90E0620BFC06EB4600968570B3EF82 │ │ │ │ │ +CC7CFC22D5F8CD7A9E04D6D83C463D9BF0E29B368EC29ED24D1FB79F2D82F6D8 │ │ │ │ │ +FC593C1FD694A5F3EED9A9E5C1C6699DDBD1A2550E406E8FED6F31534592E99F │ │ │ │ │ +0337DE9710B3508C0D014D5D2B215770E16407032203C9EB23258F69C7FC0C6C │ │ │ │ │ +84F3738362CDEFE50E5FCA1BC3991576D8B6DED99FA337BCDB1A90FB8A3F688D │ │ │ │ │ +BF7DCB42452231B5D38AFDCE44CF9D6A3711C1B02F8478986B898498E4F3BD16 │ │ │ │ │ +EFFFE41E43326AD0A934D81C078B8428C0CA7DDE8ECB713437B7358D219263F4 │ │ │ │ │ +0C72D798E9B3FB53D20C50BD7EDBAE2A72351F2E4AF2B64E6D2CDFC7A09A0210 │ │ │ │ │ +53F4460992F256BE13CFC971F19C03A66B1D70DC3F840CCC522B79C906C9DEF3 │ │ │ │ │ +36F89B25A0CF885D483DE1E8E0EBA332D3071EE0F71D0E74142FCDB29416027B │ │ │ │ │ +FEDC15CF017DB46AE7AA4B8E6778511D3FE9D8432F78BB00092509BBB3EEAA14 │ │ │ │ │ +740AD709536BF62E263DFA1295979EDC3D4CC5AA96ED9134AD8729D9D2172AD8 │ │ │ │ │ +0D6204E04E17DC5780552CB9F60A92006BA345B027D782F263EC71D46C6690A0 │ │ │ │ │ +9856FAD3223314EAD6F86A0AE583A9D0B29513400C9FC5B6CF629DE410DF4750 │ │ │ │ │ +20901A103E95134F326C5D84C293DAEF272773926006E15F7C2E6B94FFCFC5D7 │ │ │ │ │ +6EC107F2552CF79FE28CBBCDB8FEA20B0173B5FE3848BB5760CBA1D3B39AE6F2 │ │ │ │ │ +051BFA91DC90D1405DA9C07AF21CC1BFFD0F0B6C8F33AFF7DBF579587A077510 │ │ │ │ │ +6DF6BADCDFC066612B46706DC8E165AA47221A0F6D46F333805D4D7D28911E22 │ │ │ │ │ +63DB81DCD601F5A072CB466C6153C8A646DBAC6A09733F497BD36008FC30B4C5 │ │ │ │ │ +FF399CC05E61C95313F6821353E4FC5B8E69406A960622F02717688625B5A5A6 │ │ │ │ │ +CF4FBA4E08CD4DB6BDC2AADC1D45B1D5659C0FEBE226B2C200870B34486C8B3B │ │ │ │ │ +6A8C585005ADA01943C4668D293E50979C6F5822D04C4826F9BF108DAC6FEDD5 │ │ │ │ │ +02BADBB509FB6192964E1929105911D6CDA3C2AC3A46DAD7BAA1252EFE722227 │ │ │ │ │ +41B9E9A885F7F88E3A90DDD8BDAF47C425EC92AC3973AA84D25E76C64BFB6E9D │ │ │ │ │ +4B2240C4AD81ABCAA2088CF8D977B3C113FE296A58B1D189C31EC18256CC5452 │ │ │ │ │ +6E5F5A2F10821938724E560C5AD002CDBAD8E5AB7AC210184695F85ED361C1EA │ │ │ │ │ +6695FF966DED7636A68FD996A8D63C7E8A7212DF9516F01C50ABDDF0F19151DE │ │ │ │ │ +B13BBE312A682F2C0DEE56CF16272AC1EAC1B81F510EE2D3E23A70C5127FCEC9 │ │ │ │ │ +22FEE9DB2F7E9729E0D2BE0D227139460AEED366747FA6C55D0D28C01E93EBE0 │ │ │ │ │ +076C56A6A647885B03A6146CDABF5E9046D6CA4C089D0FF8D8B0E7D199AC917E │ │ │ │ │ +D2E690C3BABAE837AC024B3868C0DD7737AB84DE50FCBC28EC1712CE365C61FF │ │ │ │ │ +469596F1C54D5A3C8BDA9749B58155F820665ACCF7714CEBD0530E7AD09A2B27 │ │ │ │ │ +B6765E135E86C8E506D5D43955E03A0DCAA912FCD7F31AD24834056CBF546CC5 │ │ │ │ │ +4641693582C9E1C71192017D46A1A94650EB469DEC7A786DBD830434549DFE0B │ │ │ │ │ +03FD1DD24F6CB967742A32C5A50D2F4BBA8F3B283307AB07BA47C1CA41D31C4E │ │ │ │ │ +CC83A69E889A5E3A98D6C661237BAE1E2AD5CBFCC9027699FB6FE461B060B07F │ │ │ │ │ +A90FBB52B7AB9D6ABF03199D328C9688CC29F535DAD829A9E0B49C02CBD04F3A │ │ │ │ │ +F5C15DEC2AEA8C19837D897723780F5A680385F67D129E6DFB003994F10568E2 │ │ │ │ │ +F288EC8E7DBBF88C5ECD3B03115BC28AC1A5E02CC24F060FA2B1FC4653334D0D │ │ │ │ │ +2AA65ACC693EB79350DF101E90953FD3067307472DB76E75D5F0BA3C97EF2F2A │ │ │ │ │ +F01C94246CC420D8A79DB604E0E5AC9706A896DD3882C97B85A3C01DE092BFCB │ │ │ │ │ +41D7D1A97B3EC3521EBE7C5497411AEDF7953779FE9DF5251FB481659558F133 │ │ │ │ │ +2780AF68C61ABD0662192FC536F647F5FA99BDDBCACE4B4758F571BF56205174 │ │ │ │ │ +F39B28BBA07A01D4CAB7CAD3114A9CF9099787D0857341DB2EA0498D65987BFE │ │ │ │ │ +92110A671ABDD18362F48C65EDA2E221A349C26053654A0241A361DAAE6B89E6 │ │ │ │ │ +FF764A3E222685757ABF19CDA0C38EF15F835131AB128716328CD47A5CDA98D1 │ │ │ │ │ +129C3D2AC082596EAF6E822EDDFC88FAED6D631BF8D700723E02352916BF67D6 │ │ │ │ │ +96BBFCFBACA5E3CD644DD39239CFA195CE54177044217C519B7652D7594EC33B │ │ │ │ │ +B569A6CF4D63CCE1C3399F07305DB9EB21B04AD26025DAC68ADC8616B9610D2F │ │ │ │ │ +9A18DC01D714A94DB528441E8E4B86C21BB11BFBED954C47CDBD01D6380F868F │ │ │ │ │ +802A82F5F96938F685C75C1B84181BA798C320BFC9F6C3ECC01A9C4BA6F5C915 │ │ │ │ │ +213C6498FF436D07B0301DA4155D0EA634992750995D31709E2E9E0F133EAE6D │ │ │ │ │ +E916FE741C87FD1A56CD86E9C33731DDDBFA0A0B01324D0C62780DCAEECD166E │ │ │ │ │ +51169C648C3A8F3F3DCC4F3BBD2CA0BB571E4EC798F31FF3E34C0BD19691B411 │ │ │ │ │ +78631AEF3FA3ED7DF57D3CB845CE4BAA4FE2C6DFB2B9C8F375E42236F2CA0959 │ │ │ │ │ +ACAFF97D912188D25628B36D0E1F3BFC13E5884B868DB810877E58BA844C0165 │ │ │ │ │ +77D0C17D1D9C28DBB560501A1079C3892A52D3A41E0505BFA37D959226C5120F │ │ │ │ │ +7852432E57BF356D7483399165AFE8032AB22258A82388B5007CFBD005075F93 │ │ │ │ │ +EE491CA318CE8BD39CB69E90AA51F7E152B36A78401415259072BD98D2CCD6A8 │ │ │ │ │ +8B0A675F68C5A5011B5112E132EB7ED736E592D4615800CB47F477EEF3EA829A │ │ │ │ │ +53E0D512D81E18C4FBD18C497A2AD4ECB5A44BAB0ECC0F3D6D0DED5EE16D5A31 │ │ │ │ │ +06743D82ECA28714236827D9773E6E62B7E364F181244C735F34FBBE0C18F5A4 │ │ │ │ │ +86EAE15F637D7E10DF623BD8704A315A54BD87DAA907AC777C780906ACDA089A │ │ │ │ │ +2CF2185E892459B6CCE2931A5940D6F714C099C07A323DB157AE43D789657651 │ │ │ │ │ +DA51CAD929815D0FBB552C21A2914FE3001E89736210B7B1D474A54E55ADB07E │ │ │ │ │ +765C8607D8FDD0FE42FFFF079A67BEDF7F7C15BBD7362D971F454A9898DB2CFC │ │ │ │ │ +A285E3A8FED63A343C7B544558038BC6EC7704686665F86AB41857407F293444 │ │ │ │ │ +48BE7C88A7D4B471B076CAAD7ED3FBFC3D9297A56602497F6A5CA7A7A0B72584 │ │ │ │ │ +1724104C3148F58C2533F6FA2B21CCA5DE0D635CC8ABE2D32EF7E4A01994A450 │ │ │ │ │ +8DCEDEB9DF1558E55C329D46615DE8112532280C5DF24CAACD68CD5ED7D9D9B7 │ │ │ │ │ +79F5F35824194C0BF501AAF38FC9211B574375A2019AD9A36EEC861D20FBE41C │ │ │ │ │ +AA98D86F80025819F0525C296BFC929B0CD621D2D18739670B80EA5D82978FB4 │ │ │ │ │ +A80482C9CB31151B3685F8A332EEFBC340C40DAF2ED8C18792A021CEA62C06F3 │ │ │ │ │ +5710FF13DBF3B7ABDC791DFA6DEE09CAB78677EC7E0E0EC8447644AF4F716820 │ │ │ │ │ +E867C7440A79AE282DE65B3F697FFC13443E75CB446DAF3ECFA7 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ @@ -7542,22 +7505,21 @@ │ │ │ │ │ 44 44 44 44 44 44 44 44 44 44 44 1[44 1[44 1[44 3[44 │ │ │ │ │ 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 4[32 │ │ │ │ │ -33 33 2[42 46 4[23 1[42 1[37 46 2[42 12[60 4[65 1[76 │ │ │ │ │ -6[54 14[42 2[42 1[42 42 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 │ │ │ │ │ +56 56 2[31 46[{}33 99.6264 /CMBX12 rf /Fj 138[46 32 33 │ │ │ │ │ +33 2[42 46 4[23 1[42 1[37 46 2[42 12[60 4[65 4[43 3[54 │ │ │ │ │ +16[42 2[42 1[42 3[23 44[{}19 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 │ │ │ │ │ 0]N/FBB[-11 -15 87 40]N │ │ │ │ │ /Fl 1 43 df<006000007000006000006000406020E06070F861F07E67E01FFF8007FE00 │ │ │ │ │ 00F00007FE001FFF807E67E0F861F0E0607040602000600000600000700000600014157B │ │ │ │ │ 961E>42 D E │ │ │ │ │ /Fl load 0 Fl currentfont 50 scalefont put/FMat X/FBB │ │ │ │ │ @@ -7584,19 +7546,19 @@ │ │ │ │ │ /Ft 1 43 df<000C0000001E0000001E0000001E0000001E0000001E0000601E0180781E │ │ │ │ │ 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 1[49 13[54 5[89 5[77 3[70 69 73 9[49 2[49 │ │ │ │ │ -1[49 49 49 3[27 44[{}30 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 │ │ │ │ │ +/Fu 137[51 54 38 38 38 1[54 49 54 1[27 2[27 54 49 30 │ │ │ │ │ +43 54 43 1[49 13[54 8[50 2[77 3[70 69 73 11[49 2[49 1[49 │ │ │ │ │ +3[27 44[{}27 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 │ │ │ │ │ /setpagedevice where │ │ │ │ │ { pop << /PageSize [612 792] >> setpagedevice } │ │ │ │ │ @@ -7605,15 +7567,15 @@ │ │ │ │ │ %%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(*)1664 1261 y Fu(Ma)m(y)g(17,)e(2024)0 │ │ │ │ │ +(Services)g(Group)2942 987 y Ft(*)1657 1261 y Fu(June)f(20,)f(2025)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 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 │ │ │ │ │ @@ -7693,16 +7655,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 1889 │ │ │ │ │ -4 v 2081 w(Ma)n(y)27 b(17,)g(2024)0 390 y Fs(2)135 b(Sparse)45 │ │ │ │ │ +b(and)h(F)-7 b(ron)n(t)27 b(T)-7 b(rees)p 1442 100 1876 │ │ │ │ │ +4 v 2069 w(June)27 b(20,)g(2025)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 │ │ │ │ │ @@ -7805,16 +7767,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(Ma)n(y)27 b(17,)g(2024)p │ │ │ │ │ -570 100 1916 4 v 2079 w(Orderings)f(and)i(F)-7 b(ron)n(t)27 │ │ │ │ │ +TeXDict begin 3 2 bop 0 100 a Fj(June)27 b(20,)g(2025)p │ │ │ │ │ +582 100 1904 4 v 2067 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 │ │ │ │ │ @@ -7867,16 +7829,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 1889 │ │ │ │ │ -4 v 2081 w(Ma)n(y)27 b(17,)g(2024)125 390 y Ff(\210)42 │ │ │ │ │ +b(and)h(F)-7 b(ron)n(t)27 b(T)-7 b(rees)p 1442 100 1876 │ │ │ │ │ +4 v 2069 w(June)27 b(20,)g(2025)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 │ │ │ │ │ @@ -7947,16 +7909,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(Ma)n(y)27 b(17,)g(2024)p │ │ │ │ │ -570 100 1916 4 v 2079 w(Orderings)f(and)i(F)-7 b(ron)n(t)27 │ │ │ │ │ +TeXDict begin 5 4 bop 0 100 a Fj(June)27 b(20,)g(2025)p │ │ │ │ │ +582 100 1904 4 v 2067 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 │ │ │ │ │ @@ -8027,20 +7989,20 @@ │ │ │ │ │ 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 1889 │ │ │ │ │ -4 v 2081 w(Ma)n(y)27 b(17,)g(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(and)h(F)-7 b(ron)n(t)27 b(T)-7 b(rees)p 1442 100 1876 │ │ │ │ │ +4 v 2069 w(June)27 b(20,)g(2025)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 │ │ │ │ │ 779 y(minim)n(um)g(degree)620 b(nested)28 b(dissection)673 │ │ │ │ │ 878 y(seed)100 b(CPU)f(#)28 b(en)n(tries)297 b(#)27 b(ops)99 │ │ │ │ │ b(CPU)h(#)28 b(en)n(tries)296 b(#)28 b(ops)618 978 y(10101)170 │ │ │ │ │ b(9.2)143 b(5783892)97 b(6119141542)126 b(27.8)142 b(3410222)96 │ │ │ │ │ @@ -8104,16 +8066,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(Ma)n(y)27 b(17,)g(2024)p │ │ │ │ │ -570 100 1916 4 v 2079 w(Orderings)f(and)i(F)-7 b(ron)n(t)27 │ │ │ │ │ +TeXDict begin 7 6 bop 0 100 a Fj(June)27 b(20,)g(2025)p │ │ │ │ │ +582 100 1904 4 v 2067 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 │ │ │ │ │ @@ -8989,16 +8951,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 1889 │ │ │ │ │ -4 v 2081 w(Ma)n(y)27 b(17,)g(2024)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 1876 │ │ │ │ │ +4 v 2069 w(June)27 b(20,)g(2025)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 { │ │ │ │ │ @@ -9448,16 +9410,16 @@ │ │ │ │ │ grestore │ │ │ │ │ │ │ │ │ │ showpage │ │ │ │ │ │ │ │ │ │ %%EndDocument │ │ │ │ │ @endspecial eop end │ │ │ │ │ %%Page: 9 9 │ │ │ │ │ -TeXDict begin 9 8 bop 0 100 a Fj(Ma)n(y)27 b(17,)g(2024)p │ │ │ │ │ -570 100 1916 4 v 2079 w(Orderings)f(and)i(F)-7 b(ron)n(t)27 │ │ │ │ │ +TeXDict begin 9 8 bop 0 100 a Fj(June)27 b(20,)g(2025)p │ │ │ │ │ +582 100 1904 4 v 2067 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 │ │ │ │ │ @@ -9536,16 +9498,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 1847 │ │ │ │ │ -4 v 2039 w(Ma)n(y)27 b(17,)g(2024)0 489 y Fr(Figure)22 │ │ │ │ │ +b(and)j(F)-7 b(ron)n(t)27 b(T)-7 b(rees)p 1484 100 1834 │ │ │ │ │ +4 v 2027 w(June)27 b(20,)g(2025)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 │ │ │ │ │ @@ -10339,16 +10301,16 @@ │ │ │ │ │ grestore │ │ │ │ │ │ │ │ │ │ showpage │ │ │ │ │ │ │ │ │ │ %%EndDocument │ │ │ │ │ @endspecial eop end │ │ │ │ │ %%Page: 11 11 │ │ │ │ │ -TeXDict begin 11 10 bop 0 100 a Fj(Ma)n(y)27 b(17,)g(2024)p │ │ │ │ │ -570 100 1875 4 v 2038 w(Orderings)f(and)h(F)-7 b(ron)n(t)27 │ │ │ │ │ +TeXDict begin 11 10 bop 0 100 a Fj(June)27 b(20,)g(2025)p │ │ │ │ │ +582 100 1862 4 v 2026 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 │ │ │ │ │ @@ -10692,16 +10654,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 1847 │ │ │ │ │ -4 v 2039 w(Ma)n(y)27 b(17,)g(2024)0 864 y Fr(Figure)33 │ │ │ │ │ +b(and)j(F)-7 b(ron)n(t)27 b(T)-7 b(rees)p 1484 100 1834 │ │ │ │ │ +4 v 2027 w(June)27 b(20,)g(2025)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 │ │ │ │ │ @@ -11308,16 +11270,16 @@ │ │ │ │ │ grestore │ │ │ │ │ │ │ │ │ │ showpage │ │ │ │ │ │ │ │ │ │ %%EndDocument │ │ │ │ │ @endspecial eop end │ │ │ │ │ %%Page: 13 13 │ │ │ │ │ -TeXDict begin 13 12 bop 0 100 a Fj(Ma)n(y)27 b(17,)g(2024)p │ │ │ │ │ -570 100 1875 4 v 2038 w(Orderings)f(and)h(F)-7 b(ron)n(t)27 │ │ │ │ │ +TeXDict begin 13 12 bop 0 100 a Fj(June)27 b(20,)g(2025)p │ │ │ │ │ +582 100 1862 4 v 2026 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 │ │ │ │ │ @@ -11615,16 +11577,16 @@ │ │ │ │ │ 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 1847 │ │ │ │ │ -4 v 2039 w(Ma)n(y)27 b(17,)g(2024)0 390 y Fr(The)k(data)f(structure)g │ │ │ │ │ +b(and)j(F)-7 b(ron)n(t)27 b(T)-7 b(rees)p 1484 100 1834 │ │ │ │ │ +4 v 2027 w(June)27 b(20,)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(.)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 │ │ │ │ │ @@ -11714,16 +11676,16 @@ │ │ │ │ │ (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(Ma)n(y)27 b(17,)g(2024)p │ │ │ │ │ -570 100 1875 4 v 2038 w(Orderings)f(and)h(F)-7 b(ron)n(t)27 │ │ │ │ │ +TeXDict begin 15 14 bop 0 100 a Fj(June)27 b(20,)g(2025)p │ │ │ │ │ +582 100 1862 4 v 2026 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 │ │ │ │ │ @@ -12355,16 +12317,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 1847 │ │ │ │ │ -4 v 2039 w(Ma)n(y)27 b(17,)g(2024)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 1834 │ │ │ │ │ +4 v 2027 w(June)27 b(20,)g(2025)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 │ │ │ │ │ @@ -12684,16 +12646,16 @@ │ │ │ │ │ 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(Ma)n(y)27 b(17,)g(2024)p │ │ │ │ │ -570 100 1875 4 v 2038 w(Orderings)f(and)h(F)-7 b(ron)n(t)27 │ │ │ │ │ +TeXDict begin 17 16 bop 0 100 a Fj(June)27 b(20,)g(2025)p │ │ │ │ │ +582 100 1862 4 v 2026 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 │ │ │ │ │ @@ -12802,16 +12764,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 1847 │ │ │ │ │ -4 v 2039 w(Ma)n(y)27 b(17,)g(2024)0 390 y Fr(the)g(submatrices)e(that)i │ │ │ │ │ +b(and)j(F)-7 b(ron)n(t)27 b(T)-7 b(rees)p 1484 100 1834 │ │ │ │ │ +4 v 2027 w(June)27 b(20,)g(2025)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 │ │ │ │ │ @@ -12906,16 +12868,16 @@ │ │ │ │ │ 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(Ma)n(y)27 b(17,)g(2024)p │ │ │ │ │ -570 100 1875 4 v 2038 w(Orderings)f(and)h(F)-7 b(ron)n(t)27 │ │ │ │ │ +TeXDict begin 19 18 bop 0 100 a Fj(June)27 b(20,)g(2025)p │ │ │ │ │ +582 100 1862 4 v 2026 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 │ │ │ │ │ @@ -12995,26 +12957,25 @@ │ │ │ │ │ 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 1847 │ │ │ │ │ -4 v 2039 w(Ma)n(y)27 b(17,)g(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 │ │ │ │ │ -b(Rep)r(ort)h(SAND93-2339,)i(Sandia)171 756 y(National)27 │ │ │ │ │ -b(Lab)r(oratories,)e(Albuquerque,)i(NM,)h(1993.)0 922 │ │ │ │ │ -y([15])41 b(B.)36 b(Hendric)n(kson)f(and)h(E.)g(Roth)n(b)r(erg.)62 │ │ │ │ │ +b(and)j(F)-7 b(ron)n(t)27 b(T)-7 b(rees)p 1484 100 1834 │ │ │ │ │ +4 v 2027 w(June)27 b(20,)g(2025)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 b(Rep)r(ort)h(SAND93-2339,)i(Sandia)171 │ │ │ │ │ +756 y(National)27 b(Lab)r(oratories,)e(Albuquerque,)i(NM,)h(1993.)0 │ │ │ │ │ +922 y([15])41 b(B.)36 b(Hendric)n(kson)f(and)h(E.)g(Roth)n(b)r(erg.)62 │ │ │ │ │ b(Impro)n(ving)35 b(the)h(run)n(time)g(and)h(qualit)n(y)e(of)h(nested)h │ │ │ │ │ (dissection)f(ordering.)171 1021 y Fe(SIAM)29 b(J.)h(Sci.)g(Comput.)p │ │ │ │ │ Fr(,)f(20:468{489,)23 b(1998.)0 1187 y([16])41 b(G.)27 │ │ │ │ │ b(Karypis)e(and)i(V.)g(Kumar.)35 b(A)27 b(fast)g(and)g(high)g(qualit)n │ │ │ │ │ (y)f(m)n(ultilev)n(el)h(sc)n(heme)f(for)h(partitioning)f(irregular)e │ │ │ │ │ (graphs.)171 1287 y(T)-7 b(ec)n(hnical)32 b(Rep)r(ort)h(TR)f(95-035,)g │ │ │ │ │ (Departmen)n(t)h(of)g(Computer)f(Science,)i(Univ)n(ersit)n(y)e(of)h │ │ │ │ │ ├── ps2ascii {} │ │ │ │ │ │ @@ -1,11 +1,11 @@ │ │ │ │ │ │ Ordering Sparse Matrices and Transforming Front Trees │ │ │ │ │ │ ∗ │ │ │ │ │ │ Cleve Ashcraft, Boeing Shared Services Group │ │ │ │ │ │ - May 17, 2024 │ │ │ │ │ │ + June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 │ │ │ │ │ │ + 2 Orderings and Front Trees June 20, 2025 │ │ │ │ │ │ 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) ; │ │ │ │ │ │ - May 17, 2024 Orderings and Front Trees 3 │ │ │ │ │ │ + June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 4 Orderings and Front Trees June 20, 2025 │ │ │ │ │ │ • 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. │ │ │ │ │ │ - May 17, 2024 Orderings and Front Trees 5 │ │ │ │ │ │ + June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 6 Orderings and Front Trees June 20, 2025 │ │ │ │ │ │ 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. │ │ │ │ │ │ - May 17, 2024 Orderings and Front Trees 7 │ │ │ │ │ │ + June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 8 Orderings and Front Trees June 20, 2025 │ │ │ │ │ │ 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 │ │ │ │ │ │ - May 17, 2024 Orderings and Front Trees 9 │ │ │ │ │ │ + June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 10 Orderings and Front Trees June 20, 2025 │ │ │ │ │ │ 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 │ │ │ │ │ │ - May 17, 2024 Orderings and Front Trees 11 │ │ │ │ │ │ + June 20, 2025 Orderings and Front Trees 11 │ │ │ │ │ │ Figure 5: Block structure of L with the fundamental supernode partition. │ │ │ │ │ │ - 12 Orderings and Front Trees May 17, 2024 │ │ │ │ │ │ + 12 Orderings and Front Trees June 20, 2025 │ │ │ │ │ │ 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 │ │ │ │ │ │ - May 17, 2024 Orderings and Front Trees 13 │ │ │ │ │ │ + June 20, 2025 Orderings and Front Trees 13 │ │ │ │ │ │ Figure 7: Block structure of L with the amalgamated supernode partition. │ │ │ │ │ │ - 14 Orderings and Front Trees May 17, 2024 │ │ │ │ │ │ + 14 Orderings and Front Trees June 20, 2025 │ │ │ │ │ │ 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. │ │ │ │ │ │ - May 17, 2024 Orderings and Front Trees 15 │ │ │ │ │ │ + June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 16 Orderings and Front Trees June 20, 2025 │ │ │ │ │ │ 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 │ │ │ │ │ │ - May 17, 2024 Orderings and Front Trees 17 │ │ │ │ │ │ + June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 18 Orderings and Front Trees June 20, 2025 │ │ │ │ │ │ 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. │ │ │ │ │ │ - May 17, 2024 Orderings and Front Trees 19 │ │ │ │ │ │ + June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 20 Orderings and Front Trees June 20, 2025 │ │ │ │ │ │ [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 2024.05.17:2217 │ │ │ │ │ +%DVIPSSource: TeX output 2025.06.20:0449 │ │ │ │ │ %%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 │ │ │ │ │ @@ -1788,22 +1788,21 @@ │ │ │ │ │ /UnderlinePosition -100 def │ │ │ │ │ /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 49 /one put │ │ │ │ │ dup 50 /two put │ │ │ │ │ -dup 52 /four put │ │ │ │ │ -dup 55 /seven put │ │ │ │ │ +dup 53 /five put │ │ │ │ │ dup 58 /colon put │ │ │ │ │ -dup 77 /M put │ │ │ │ │ -dup 97 /a put │ │ │ │ │ -dup 121 /y put │ │ │ │ │ +dup 74 /J put │ │ │ │ │ +dup 101 /e put │ │ │ │ │ +dup 110 /n put │ │ │ │ │ +dup 117 /u put │ │ │ │ │ readonly def │ │ │ │ │ currentdict end │ │ │ │ │ currentfile eexec │ │ │ │ │ D9D66F633B846AB284BCF8B0411B772DE5CE32340DC6F28AF40857E4451976E7 │ │ │ │ │ 5182433CF9F333A38BD841C0D4E68BF9E012EB32A8FFB76B5816306B5EDF7C99 │ │ │ │ │ 8B3A16D9B4BC056662E32C7CD0123DFAEB734C7532E64BBFBF5A60336E646716 │ │ │ │ │ EFB852C877F440D329172C71F1E5D59CE9473C26B8AEF7AD68EF0727B6EC2E0C │ │ │ │ │ @@ -1984,72 +1983,64 @@ │ │ │ │ │ 7CA1534C4D5B05FC33F83790ECFD7641DF3FB94289E2A1F6E7D29AB1228A867A │ │ │ │ │ 6E1EF0E9C6F899B491DC18401C2C0A05FFFED46A72C245F7529B8EA55A038082 │ │ │ │ │ 8512307217D2A233C37004085BA3AEE379269F9FA7D0ADB4B19A95CC2AFE686E │ │ │ │ │ 55D88E47257C1FE6F235FEA295910569FE6DD5995512562359CC821E85A6C7A5 │ │ │ │ │ 79B470A9E340A6985189FF8B6AF914A6B0ECF93F47903221F95DE894A8F05B05 │ │ │ │ │ B7D99CD533EC5F931B18E6B39BECF67FA2D6DD1AEC76772B068BE06335A94C05 │ │ │ │ │ 7A4DDEE77B66101DA855C17AC312600370B34E31F5EC3A01300A8EB60B4C9767 │ │ │ │ │ -1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004B9BA1CC │ │ │ │ │ -580D3C6BDA4DC1B80B4365F1C80512453FC5316EC2D928FB731C3D6403E3C18B │ │ │ │ │ -E8424D644DF5E9A2134229C5C91CA68DB8E85BA2BB40F538F585DA6FA4037718 │ │ │ │ │ -B8053EBBA1E765346BCD5BDAA6C38115D31611D8A87A2238C145F2DA2F92E4DF │ │ │ │ │ -3987BD9C4D2A3D460E8941A68B125BCD9EE4F9FD262C4C8A71F47A2C81975635 │ │ │ │ │ -F1B981C274C53FA2ACCDE4C9D0A7C62D6C1EFF91CFC6712CA6A9F333C9564FCB │ │ │ │ │ -2A70F0AD715A79B10A08AB069E2A3C93BC0AED19D0CA10134B8DDDE8AF548DB2 │ │ │ │ │ -3A4AAA9C29682CF135BB767DAA16169A127EB50A7EECEB6480CF56A7D0F8AC56 │ │ │ │ │ -4A5090B3D75A790372886AF568D94C8165975A05BFBFDF1FFBA45F70700BB9E0 │ │ │ │ │ -57F3249EF9E9C8AD9CBCF6E4FD592DC4CDD2CC7C0BC3130C1059096C657BE453 │ │ │ │ │ -A2CBACE93420210E27AF56CA229BD6D982FB68B3FDC6D44478B922C4231C47EE │ │ │ │ │ -E500232F6C11D92DEB955F66DF52B92B22E7352790CC2DCBAC53965D57AC2920 │ │ │ │ │ -68B7D520DE25047146EFEB06B9AD4E2A94243C7E5239F0BC2FC312B16051D52C │ │ │ │ │ -0B92C217B6B42997321AE4F8BB066754B7AA3F15069EF59224E8A442CE471AA7 │ │ │ │ │ -E8049A3DD9EDA09CCEE4998998661CF7DB35E952F6C65DAEB3013951C59F3E09 │ │ │ │ │ -157F313B0237876E1C0190F0473819570B8C0205AADF05D787CC00979CFB327A │ │ │ │ │ -289382B22DDA6F12804ED0ED5B179E36A995A2A59E1B66E75130DBE9109C813B │ │ │ │ │ -94403E0DEA8314A1E9DB474D7FA83C0BAFD08033E6A6215844C1D26BE15F1251 │ │ │ │ │ -A1605E8DF9A9C601ED37379530BC1C82BE5463C6C711C5652BFD6262485AA9CA │ │ │ │ │ -B8C4A117593001D08D980041E2A83C190DCE8E6CD3D334E5CC19FC05DB30F7F7 │ │ │ │ │ -24A305C4DBB31F0651392B99D44B4302333BDF7E326FD256DD75D309C6E73F85 │ │ │ │ │ -FA71B35FD1F9BEFF4C7A1076362EEB0A85492933B6006086A7B8C1928CF2D1EE │ │ │ │ │ -FD4344409257BB802C117E739960821CD3C88BFBA5669FF16F610AD638AF3677 │ │ │ │ │ -8674C985E6767253ED5769F71BEA5E9BB02A751F9E62EE2B18AC19D975FDEAE9 │ │ │ │ │ -8B8822367FF177A7E850766DE99ED3366D46464612926430012212A90F8E85F4 │ │ │ │ │ -4760B40D5B86B90819EE410382C23E86DCAF4F0FF5DFEB2C285965F4DCF2FB2B │ │ │ │ │ -457C0A0427A8D4ADA514E9DACD0F9367E1DA225DB21DA4DDAE33F2B529686D92 │ │ │ │ │ -AC085B345565F9DFFA012FD494DBB2E0B44A0787B2B72DC8D25399DAAE8864B7 │ │ │ │ │ -E84AA99DAFCEAF18F8B41882720316450F1B1CA48B418C9736E5CE4AFF996111 │ │ │ │ │ -5F7FE80958B6A3498508E9693CB134402D92E30D4C2939070D4647E13682290E │ │ │ │ │ -1D0820A3FCA7147157D09D1A40771F214EAE7DD743EA26839E535CA186C05CB8 │ │ │ │ │ -4874988AA1104D85AF0220FE7224344FF624E794BD2454E1C0AC971522FBECBA │ │ │ │ │ -B2497F25CD621B77EC5160973EF5ECC39C183DC051B0DFCB090194A2525BD96E │ │ │ │ │ -28593FDA80D8D259F039416D5F9AF0AD3C9A105B49DAF6E681921E369B7666C6 │ │ │ │ │ -2B73DB37447B00AE96317C2F1C44FB6E6EFD740BAB20FA03A8CE018EC8415582 │ │ │ │ │ -FB06E88A2971E3A480FB1EB4FE93CC7E5179721CAABEE88742B13CF0405F49F4 │ │ │ │ │ -945E587668C821D8C06D6847B6DF84CAFFCD4628670D551FC5F7236875BE1207 │ │ │ │ │ -634BA7F70A19B658FAE7D86F6D00ED28FBF29CC585DEE279325EEF8B0CCB6149 │ │ │ │ │ -E46E638C73D75148F18A636DBC2DD96ED34F68A5A09A3700B1EA34B2D142807C │ │ │ │ │ -F8709D81180783548EAE6F457BF968602076A1069163E3C15BBCEF659C6CF2E6 │ │ │ │ │ -0BB01BDC8E503802CC7969A5B8477E9788C5249B23B19669F5075E089738E49A │ │ │ │ │ -8671D7C1B1B47652F3D78BF2FF74EDB44BA5B092E8D5B85001E97F69D54AEEFC │ │ │ │ │ -88FC3CA1B0D5BAC39263B371005BCFA19AD197A31CC34D0BD55C2CA18C60C485 │ │ │ │ │ -5993F736EF1DD2C5D2B4D50B3D498861B4DF5E7AFF614BBCA4C2E6BECC0DCEF5 │ │ │ │ │ -95F0D686188014C530D8E37650CDCAE721B4AFB0F178BC744BDDDED45DAB7FEB │ │ │ │ │ -A10B975E26099E3DC61116D6BF554574F948895B88EEFE03DCC5351190836AD4 │ │ │ │ │ -EBC1AC55C6D099A8E7B0A372D290C481F44FA464B9C11A0BC991CB045E0AAAC4 │ │ │ │ │ -5C73CA43A4F17D1ADDD33D1B917FF95BFF411C8409F41553B1BC97DE47E3A1F4 │ │ │ │ │ -A5C1D1B7B1BF7E2507AC53956C141411F4F657E37981996DD7BB7ADB2CB6AE01 │ │ │ │ │ -73D0876B8F896F626D5022FE53BA34D5668BD698BE8D5CCAD083CBCEF440BE6A │ │ │ │ │ -8090EB1CDEE5F99C8988650BD4E539B357C31C597D8A9104A9D5967D4E906CAD │ │ │ │ │ -2A65575A884B1C5F6CC509E742FA9DDD66494F219178161AF72C50848E226A95 │ │ │ │ │ -A8C247FF9FF0BABD073021271B5C0692F9BE220071DAB09E5A026629371EE3C4 │ │ │ │ │ -A6E4FA94625D87A5B66EF077ED54C72B1052AEAA9637B30C76EF8EB04AD5F476 │ │ │ │ │ -D15F1C93C0BC6E0F67B366097BBED03FE82C040F9EF02866159B46854E11D44F │ │ │ │ │ -54AE6748A7E61B993A4EECD3B8BE3B5897A66BBCDFE24F65BC2AD5AB49048CF1 │ │ │ │ │ -647203823F84DF5CB483096F9D96AEE3A2855E479B72A14A67C633CE99C101CF │ │ │ │ │ -EFAE939BF9B02E710D │ │ │ │ │ +1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004ACD1870 │ │ │ │ │ +A5EA947858F5795870BFE1343AD803FB854BF8F5A4E794E8EC57BE41DB5B8734 │ │ │ │ │ +13E47950F29A81EA0C81EA798863883D7F41F78325CA190CBBFFE822AE494550 │ │ │ │ │ +4BE83703071FC9512D128927AF3F63CEF8F86ABE1E15D7B4DDD39576E7DFF45E │ │ │ │ │ +3CB4115AAB1830DE8647B915DB4BEBEB5235C281E098B899BAB951D8D5798F01 │ │ │ │ │ +7F7C47336D31438E5126738AFEAB29E9A7CBE06DE4DD604477B542D2620DFD58 │ │ │ │ │ +28FE34238572F23C5A8EB7ACEE1E154DA13FC1A5AA67A3BA8C5CDFB2B80312C9 │ │ │ │ │ +BC9FAE56D08DDFA9498E6EF0D0F6BD18B3923E0B670B0740528BC843610736CB │ │ │ │ │ +80228C105C2F72C3C22D610C3D8C268DEEA2AEEE3221E198E79FE2966487360C │ │ │ │ │ +84AE08AC326F48B21447652121B1EB68AF856055EEA65B6B625BF622CBFC2D1C │ │ │ │ │ +EF943CC4CAF2C715782C9EF9A9BA4689BFC6B6A82F8D55795BE8111E2C7DE520 │ │ │ │ │ +367362304B6A48186C842033E715A46265A352472F4F7313248EBCD26BEA97E7 │ │ │ │ │ +B814A61D4B7ADCB5C5F21AA34E0C1269E8426DBFB511DE6E26B960456C8F8520 │ │ │ │ │ +5F0DD382289A62AF0B935EDB5B2394538C5F0EE72962D2F98F3C38CD7C027B9F │ │ │ │ │ +E230E67E40FEFBDED06B3423C9DFD669E6B5BC913E0FF75786A64A6C11D4FE89 │ │ │ │ │ +1B918DC0E953C52CFD153063CD0D2A78B43F8712243845E6F2CBA1DB610F403D │ │ │ │ │ +A98D06D95FF44C7AC029092B666A8B0DCEA95B34F5ACC10E8611BADE6A24469C │ │ │ │ │ +0C01D95BFB445FA22CD38D033E4D24E006BB9D54EE41EF7AD5AC9C299721F61A │ │ │ │ │ +F01B6EDCDF428BD9195A13C5B1027358F8A203F828A1DD9622243B2D76C6F1BA │ │ │ │ │ +9F2D7E9D4879FC668ABC750CD25415DC6CCF2257C28F78D3F9BE499CC0FF2F80 │ │ │ │ │ +2C2CD1DEFABD6668FCA76E1D629A344333E33DA24B86D2E9F8F5EE1C29974640 │ │ │ │ │ +C3E78E999BAB313400041DADDDFDBFFCC419F129A84F4D412B79E8BE4511CA00 │ │ │ │ │ +F92A4F3CDD2E51345D3965C104F06B6503445DC20224CB7606A9D7D5F9EE45E6 │ │ │ │ │ +1B2963DA96AA2AB1BA5BE29656E666E4D0E122DE58EEA68E04ED76438DA03E65 │ │ │ │ │ +B80055A86B7B2A26BAE6BBB8835E17F9696E9B3CD34571BA75C76D4D2CCC48F1 │ │ │ │ │ +7534C1EF9127E374D65D05B8072E08D6C72A0B4A35EA0DD717743C66D105CCD8 │ │ │ │ │ +7355F13E9C38C1A4351624E689ED7909100942FA0474842EE44DEC3279E1A1CD │ │ │ │ │ +8064666EB845CA7C3E906B67C0BF96A28D514DB2E4A1E4AF287350B03762A2CF │ │ │ │ │ +13B18AC3F5D2F3B74A1D50267C03EFB74B888E1D24ABEEA4A885F4D0BF14C0D8 │ │ │ │ │ +289AC79D6D98E2A2C831672FB1F3457564CD161ADC3AF610D88201AB5B0C10CB │ │ │ │ │ +5ECCC2D5C4AF39C8CB3044BF9EC791BA45D29C2B51EA0483D19822C264CE6FA3 │ │ │ │ │ +5C97F2DF5A78CB93528E99B9ED7CB121C83130C129B849B52A36EBD88AF19DD3 │ │ │ │ │ +C5CABE831027388EF86BD5CBD90AAAC089775938A321C44D4DDA67A51312D8AB │ │ │ │ │ +C509DDBE7044A107AB2BE9C4C9556F85C529B174A7778B489BF28EC07A834542 │ │ │ │ │ +8B31F2925C21FB2096877711F998763D5A8495002B8E080AF8DBB1B3106EDDBA │ │ │ │ │ +35121D52E0846A7AF3ABEDF87BDE4FA665673A9B80CA538B98F873947AA17EF4 │ │ │ │ │ +9BB182917E9D79BC7EC681E93710D6A1D6B0E4A7FA9452FC1C431808174F3AB7 │ │ │ │ │ +F3914FBC86CB34E8583457243C3C7BE4BC166C7397689BC6FFB82EA2967E88EE │ │ │ │ │ +464F96EDA144DE2B64401B8E577ABCA2D826FE0B92E21FFAE3E81EBB6B6EB36E │ │ │ │ │ +9B1A8FE3884CA398C03135FD49D51724FC1268E9482E41FAEA2FC6C809006B8F │ │ │ │ │ +5D4F9E038450AD3A6041C16FD1C7E5FC80C0E033CE57E64863E014531D94DF1E │ │ │ │ │ +31D7D038AFCB60715AA73C1E96F113A24C5AF35BBEB61C4D079ED034ED83AA4A │ │ │ │ │ +E12448E618330463304788BCF40561CD63167B3BF144F408E2B89E60B8BA13EF │ │ │ │ │ +3B57D286FD23D4FA8BAEFF98DC1188B1982956CC1DCAEFC7D949B7B4E3BE8F8A │ │ │ │ │ +BFE2C9D938DD13EFEE7123576608D9396F260907DA98AE2D3DD5822306CBC8A6 │ │ │ │ │ +B083C697DDA3C62EE7879436A9FD8EE0034B105105B3F122F893EA2126EBE8A9 │ │ │ │ │ +5CBF2BD248DD9FBEF0040C25797BD13B69A8C9F0D4E4F935C61ED30487CCDB1A │ │ │ │ │ +0339006E78EE1755929D2412776EC7DB1F666DBDD28EA8AC7397F809C7F38A41 │ │ │ │ │ +5B3BF6C75F4F35C90141EB08377AF452CF840FEA938805F9D14E02DC29215B4E │ │ │ │ │ +F1EB │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ @@ -5486,17 +5477,17 @@ │ │ │ │ │ 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 23[45 19[83 18[25 │ │ │ │ │ -2[45 2[45 1[45 45 45 3[25 44[{}10 90.9091 /CMSL10 rf │ │ │ │ │ -/Fh 156[83 46 78[61 61 18[{}4 83.022 /CMEX10 rf /Fi 145[45 │ │ │ │ │ +63[{}5 90.9091 /CMBX10 rf /Fg 138[51 6[51 8[40 26[47 │ │ │ │ │ +15[25 4[45 2[45 1[45 3[25 44[{}9 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 │ │ │ │ │ @@ -5645,17 +5636,17 @@ │ │ │ │ │ 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 1179 4 v │ │ │ │ │ -1361 w Fo(GPart)29 b Fg(:)40 b Fm(DRAFT)31 b Fg(Ma)m(y)g(17,)h(2024)p │ │ │ │ │ -2721 100 V 0 399 a Fp(This)d(pro)s(cess)h(w)m(e)g(call)i │ │ │ │ │ +TeXDict begin 2 1 bop 0 100 a Fp(2)p 136 100 1172 4 v │ │ │ │ │ +1354 w Fo(GPart)29 b Fg(:)41 b Fm(DRAFT)30 b Fg(June)f(20,)j(2025)p │ │ │ │ │ +2728 100 V 0 399 a Fp(This)d(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 │ │ │ │ │ @@ -5710,17 +5701,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 1179 4 v 1360 100 a Fo(GPart)29 │ │ │ │ │ -b Fg(:)41 b Fm(DRAFT)121 b Fg(Ma)m(y)32 b(17,)f(2024)p │ │ │ │ │ -2674 100 V 1179 w Fp(3)330 399 y Ff({)45 b Fo(int)i(minweight)p │ │ │ │ │ +TeXDict begin 3 2 bop 91 100 1172 4 v 1353 100 a Fo(GPart)29 │ │ │ │ │ +b Fg(:)41 b Fm(DRAFT)121 b Fg(June)30 b(20,)h(2025)p │ │ │ │ │ +2681 100 V 1172 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 │ │ │ │ │ @@ -5784,17 +5775,17 @@ │ │ │ │ │ (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 1179 4 v │ │ │ │ │ -1361 w Fo(GPart)29 b Fg(:)40 b Fm(DRAFT)31 b Fg(Ma)m(y)g(17,)h(2024)p │ │ │ │ │ -2721 100 V 0 399 a Fb(1.2.1)112 b(Basic)38 b(metho)s(ds)0 │ │ │ │ │ +TeXDict begin 4 3 bop 0 100 a Fp(4)p 136 100 1172 4 v │ │ │ │ │ +1354 w Fo(GPart)29 b Fg(:)41 b Fm(DRAFT)30 b Fg(June)f(20,)j(2025)p │ │ │ │ │ +2728 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) │ │ │ │ │ @@ -5854,17 +5845,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 1179 4 v 1360 100 a Fo(GPart)29 │ │ │ │ │ -b Fg(:)41 b Fm(DRAFT)121 b Fg(Ma)m(y)32 b(17,)f(2024)p │ │ │ │ │ -2674 100 V 1179 w Fp(5)0 399 y Fb(1.2.3)112 b(Utilit)m(y)38 │ │ │ │ │ +TeXDict begin 5 4 bop 91 100 1172 4 v 1353 100 a Fo(GPart)29 │ │ │ │ │ +b Fg(:)41 b Fm(DRAFT)121 b Fg(June)30 b(20,)h(2025)p │ │ │ │ │ +2681 100 V 1172 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 │ │ │ │ │ @@ -5944,17 +5935,17 @@ │ │ │ │ │ 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 1179 4 v │ │ │ │ │ -1361 w Fo(GPart)29 b Fg(:)40 b Fm(DRAFT)31 b Fg(Ma)m(y)g(17,)h(2024)p │ │ │ │ │ -2721 100 V 111 399 a Fp(6.)46 b Fo(IV)h(*)h(GPart_bndWeightsIV)43 │ │ │ │ │ +TeXDict begin 6 5 bop 0 100 a Fp(6)p 136 100 1172 4 v │ │ │ │ │ +1354 w Fo(GPart)29 b Fg(:)41 b Fm(DRAFT)30 b Fg(June)f(20,)j(2025)p │ │ │ │ │ +2728 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 │ │ │ │ │ @@ -6025,17 +6016,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 1179 4 v 1360 100 a Fo(GPart)29 │ │ │ │ │ -b Fg(:)41 b Fm(DRAFT)121 b Fg(Ma)m(y)32 b(17,)f(2024)p │ │ │ │ │ -2674 100 V 1179 w Fp(7)227 399 y(Kernighan-Lin)k(algorithm)h(to)g │ │ │ │ │ +TeXDict begin 7 6 bop 91 100 1172 4 v 1353 100 a Fo(GPart)29 │ │ │ │ │ +b Fg(:)41 b Fm(DRAFT)121 b Fg(June)30 b(20,)h(2025)p │ │ │ │ │ +2681 100 V 1172 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 │ │ │ │ │ @@ -6134,17 +6125,17 @@ │ │ │ │ │ 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 1179 4 v │ │ │ │ │ -1361 w Fo(GPart)29 b Fg(:)40 b Fm(DRAFT)31 b Fg(Ma)m(y)g(17,)h(2024)p │ │ │ │ │ -2721 100 V 227 399 a Fp(The)d Fo(YVmapIV)e Fp(ob)5 b(ject)30 │ │ │ │ │ +TeXDict begin 8 7 bop 0 100 a Fp(8)p 136 100 1172 4 v │ │ │ │ │ +1354 w Fo(GPart)29 b Fg(:)41 b Fm(DRAFT)30 b Fg(June)f(20,)j(2025)p │ │ │ │ │ +2728 100 V 227 399 a Fp(The)d 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 │ │ │ │ │ @@ -6255,17 +6246,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 1179 4 v 1360 100 a Fo(GPart)29 │ │ │ │ │ -b Fg(:)41 b Fm(DRAFT)121 b Fg(Ma)m(y)32 b(17,)f(2024)p │ │ │ │ │ -2674 100 V 1179 w Fp(9)0 399 y Fb(1.2.7)112 b(Recursiv)m(e)38 │ │ │ │ │ +TeXDict begin 9 8 bop 91 100 1172 4 v 1353 100 a Fo(GPart)29 │ │ │ │ │ +b Fg(:)41 b Fm(DRAFT)121 b Fg(June)30 b(20,)h(2025)p │ │ │ │ │ +2681 100 V 1172 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 │ │ │ │ │ @@ -6328,17 +6319,17 @@ │ │ │ │ │ (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 1156 4 │ │ │ │ │ -v 1339 w Fo(GPart)29 b Fg(:)40 b Fm(DRAFT)30 b Fg(Ma)m(y)i(17,)f(2024)p │ │ │ │ │ -2744 100 V 111 399 a Fp(4.)46 b Fo(void)h(DDsepInfo_free)d(\()j │ │ │ │ │ +TeXDict begin 10 9 bop 0 100 a Fp(10)p 182 100 1149 4 │ │ │ │ │ +v 1332 w Fo(GPart)29 b Fg(:)40 b Fm(DRAFT)30 b Fg(June)g(20,)h(2025)p │ │ │ │ │ +2751 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 │ │ │ │ │ @@ -6391,17 +6382,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 1156 4 v 1338 100 a Fo(GPart)29 │ │ │ │ │ -b Fg(:)40 b Fm(DRAFT)121 b Fg(Ma)m(y)32 b(17,)f(2024)p │ │ │ │ │ -2651 100 V 1156 w Fp(11)337 399 y Fn(\210)45 b Fp(The)30 │ │ │ │ │ +TeXDict begin 11 10 bop 91 100 1149 4 v 1331 100 a Fo(GPart)29 │ │ │ │ │ +b Fg(:)40 b Fm(DRAFT)121 b Fg(June)30 b(20,)h(2025)p │ │ │ │ │ +2658 100 V 1149 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 │ │ │ │ │ @@ -6470,18 +6461,18 @@ │ │ │ │ │ 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 1156 │ │ │ │ │ -4 v 1339 w Fo(GPart)29 b Fg(:)40 b Fm(DRAFT)30 b Fg(Ma)m(y)i(17,)f │ │ │ │ │ -(2024)p 2744 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 │ │ │ │ │ +TeXDict begin 12 11 bop 0 100 a Fp(12)p 182 100 1149 │ │ │ │ │ +4 v 1332 w Fo(GPart)29 b Fg(:)40 b Fm(DRAFT)30 b Fg(June)g(20,)h(2025)p │ │ │ │ │ +2751 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 │ │ │ │ │ @@ -6551,17 +6542,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 1156 4 v 1338 100 a Fo(GPart)29 │ │ │ │ │ -b Fg(:)40 b Fm(DRAFT)121 b Fg(Ma)m(y)32 b(17,)f(2024)p │ │ │ │ │ -2651 100 V 1156 w Fp(13)337 399 y Fn(\210)45 b Fp(The)c │ │ │ │ │ +TeXDict begin 13 12 bop 91 100 1149 4 v 1331 100 a Fo(GPart)29 │ │ │ │ │ +b Fg(:)40 b Fm(DRAFT)121 b Fg(June)30 b(20,)h(2025)p │ │ │ │ │ +2658 100 V 1149 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 │ │ │ │ │ @@ -6631,20 +6622,20 @@ │ │ │ │ │ 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 1156 │ │ │ │ │ -4 v 1339 w Fo(GPart)29 b Fg(:)40 b Fm(DRAFT)30 b Fg(Ma)m(y)i(17,)f │ │ │ │ │ -(2024)p 2744 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 │ │ │ │ │ +TeXDict begin 14 13 bop 0 100 a Fp(14)p 182 100 1149 │ │ │ │ │ +4 v 1332 w Fo(GPart)29 b Fg(:)40 b Fm(DRAFT)30 b Fg(June)g(20,)h(2025)p │ │ │ │ │ +2751 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 │ │ │ │ │ ├── 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 May 17, 2024 │ │ │ │ │ │ + 2 GPart : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 3 │ │ │ │ │ │ + GPart : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 4 GPart : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 5 │ │ │ │ │ │ + GPart : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 6 GPart : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 7 │ │ │ │ │ │ + GPart : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 8 GPart : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 9 │ │ │ │ │ │ + GPart : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 10 GPart : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 11 │ │ │ │ │ │ + GPart : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 12 GPart : DRAFT June 20, 2025 │ │ │ │ │ │ • 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 May 17, 2024 13 │ │ │ │ │ │ + GPart : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 14 GPart : DRAFT June 20, 2025 │ │ │ │ │ │ • 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 2024.05.17:2217 │ │ │ │ │ +%DVIPSSource: TeX output 2025.06.20:0449 │ │ │ │ │ %%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 │ │ │ │ │ @@ -1202,22 +1202,21 @@ │ │ │ │ │ /UnderlinePosition -100 def │ │ │ │ │ /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 49 /one put │ │ │ │ │ dup 50 /two put │ │ │ │ │ -dup 52 /four put │ │ │ │ │ -dup 55 /seven put │ │ │ │ │ +dup 53 /five put │ │ │ │ │ dup 58 /colon put │ │ │ │ │ -dup 77 /M put │ │ │ │ │ -dup 97 /a put │ │ │ │ │ -dup 121 /y put │ │ │ │ │ +dup 74 /J put │ │ │ │ │ +dup 101 /e put │ │ │ │ │ +dup 110 /n put │ │ │ │ │ +dup 117 /u put │ │ │ │ │ readonly def │ │ │ │ │ currentdict end │ │ │ │ │ currentfile eexec │ │ │ │ │ D9D66F633B846AB284BCF8B0411B772DE5CE32340DC6F28AF40857E4451976E7 │ │ │ │ │ 5182433CF9F333A38BD841C0D4E68BF9E012EB32A8FFB76B5816306B5EDF7C99 │ │ │ │ │ 8B3A16D9B4BC056662E32C7CD0123DFAEB734C7532E64BBFBF5A60336E646716 │ │ │ │ │ EFB852C877F440D329172C71F1E5D59CE9473C26B8AEF7AD68EF0727B6EC2E0C │ │ │ │ │ @@ -1398,72 +1397,64 @@ │ │ │ │ │ 7CA1534C4D5B05FC33F83790ECFD7641DF3FB94289E2A1F6E7D29AB1228A867A │ │ │ │ │ 6E1EF0E9C6F899B491DC18401C2C0A05FFFED46A72C245F7529B8EA55A038082 │ │ │ │ │ 8512307217D2A233C37004085BA3AEE379269F9FA7D0ADB4B19A95CC2AFE686E │ │ │ │ │ 55D88E47257C1FE6F235FEA295910569FE6DD5995512562359CC821E85A6C7A5 │ │ │ │ │ 79B470A9E340A6985189FF8B6AF914A6B0ECF93F47903221F95DE894A8F05B05 │ │ │ │ │ B7D99CD533EC5F931B18E6B39BECF67FA2D6DD1AEC76772B068BE06335A94C05 │ │ │ │ │ 7A4DDEE77B66101DA855C17AC312600370B34E31F5EC3A01300A8EB60B4C9767 │ │ │ │ │ -1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004B9BA1CC │ │ │ │ │ -580D3C6BDA4DC1B80B4365F1C80512453FC5316EC2D928FB731C3D6403E3C18B │ │ │ │ │ -E8424D644DF5E9A2134229C5C91CA68DB8E85BA2BB40F538F585DA6FA4037718 │ │ │ │ │ -B8053EBBA1E765346BCD5BDAA6C38115D31611D8A87A2238C145F2DA2F92E4DF │ │ │ │ │ -3987BD9C4D2A3D460E8941A68B125BCD9EE4F9FD262C4C8A71F47A2C81975635 │ │ │ │ │ -F1B981C274C53FA2ACCDE4C9D0A7C62D6C1EFF91CFC6712CA6A9F333C9564FCB │ │ │ │ │ -2A70F0AD715A79B10A08AB069E2A3C93BC0AED19D0CA10134B8DDDE8AF548DB2 │ │ │ │ │ -3A4AAA9C29682CF135BB767DAA16169A127EB50A7EECEB6480CF56A7D0F8AC56 │ │ │ │ │ -4A5090B3D75A790372886AF568D94C8165975A05BFBFDF1FFBA45F70700BB9E0 │ │ │ │ │ -57F3249EF9E9C8AD9CBCF6E4FD592DC4CDD2CC7C0BC3130C1059096C657BE453 │ │ │ │ │ -A2CBACE93420210E27AF56CA229BD6D982FB68B3FDC6D44478B922C4231C47EE │ │ │ │ │ -E500232F6C11D92DEB955F66DF52B92B22E7352790CC2DCBAC53965D57AC2920 │ │ │ │ │ -68B7D520DE25047146EFEB06B9AD4E2A94243C7E5239F0BC2FC312B16051D52C │ │ │ │ │ -0B92C217B6B42997321AE4F8BB066754B7AA3F15069EF59224E8A442CE471AA7 │ │ │ │ │ -E8049A3DD9EDA09CCEE4998998661CF7DB35E952F6C65DAEB3013951C59F3E09 │ │ │ │ │ -157F313B0237876E1C0190F0473819570B8C0205AADF05D787CC00979CFB327A │ │ │ │ │ -289382B22DDA6F12804ED0ED5B179E36A995A2A59E1B66E75130DBE9109C813B │ │ │ │ │ -94403E0DEA8314A1E9DB474D7FA83C0BAFD08033E6A6215844C1D26BE15F1251 │ │ │ │ │ -A1605E8DF9A9C601ED37379530BC1C82BE5463C6C711C5652BFD6262485AA9CA │ │ │ │ │ -B8C4A117593001D08D980041E2A83C190DCE8E6CD3D334E5CC19FC05DB30F7F7 │ │ │ │ │ -24A305C4DBB31F0651392B99D44B4302333BDF7E326FD256DD75D309C6E73F85 │ │ │ │ │ -FA71B35FD1F9BEFF4C7A1076362EEB0A85492933B6006086A7B8C1928CF2D1EE │ │ │ │ │ -FD4344409257BB802C117E739960821CD3C88BFBA5669FF16F610AD638AF3677 │ │ │ │ │ -8674C985E6767253ED5769F71BEA5E9BB02A751F9E62EE2B18AC19D975FDEAE9 │ │ │ │ │ -8B8822367FF177A7E850766DE99ED3366D46464612926430012212A90F8E85F4 │ │ │ │ │ -4760B40D5B86B90819EE410382C23E86DCAF4F0FF5DFEB2C285965F4DCF2FB2B │ │ │ │ │ -457C0A0427A8D4ADA514E9DACD0F9367E1DA225DB21DA4DDAE33F2B529686D92 │ │ │ │ │ -AC085B345565F9DFFA012FD494DBB2E0B44A0787B2B72DC8D25399DAAE8864B7 │ │ │ │ │ -E84AA99DAFCEAF18F8B41882720316450F1B1CA48B418C9736E5CE4AFF996111 │ │ │ │ │ -5F7FE80958B6A3498508E9693CB134402D92E30D4C2939070D4647E13682290E │ │ │ │ │ -1D0820A3FCA7147157D09D1A40771F214EAE7DD743EA26839E535CA186C05CB8 │ │ │ │ │ -4874988AA1104D85AF0220FE7224344FF624E794BD2454E1C0AC971522FBECBA │ │ │ │ │ -B2497F25CD621B77EC5160973EF5ECC39C183DC051B0DFCB090194A2525BD96E │ │ │ │ │ -28593FDA80D8D259F039416D5F9AF0AD3C9A105B49DAF6E681921E369B7666C6 │ │ │ │ │ -2B73DB37447B00AE96317C2F1C44FB6E6EFD740BAB20FA03A8CE018EC8415582 │ │ │ │ │ -FB06E88A2971E3A480FB1EB4FE93CC7E5179721CAABEE88742B13CF0405F49F4 │ │ │ │ │ -945E587668C821D8C06D6847B6DF84CAFFCD4628670D551FC5F7236875BE1207 │ │ │ │ │ -634BA7F70A19B658FAE7D86F6D00ED28FBF29CC585DEE279325EEF8B0CCB6149 │ │ │ │ │ -E46E638C73D75148F18A636DBC2DD96ED34F68A5A09A3700B1EA34B2D142807C │ │ │ │ │ -F8709D81180783548EAE6F457BF968602076A1069163E3C15BBCEF659C6CF2E6 │ │ │ │ │ -0BB01BDC8E503802CC7969A5B8477E9788C5249B23B19669F5075E089738E49A │ │ │ │ │ -8671D7C1B1B47652F3D78BF2FF74EDB44BA5B092E8D5B85001E97F69D54AEEFC │ │ │ │ │ -88FC3CA1B0D5BAC39263B371005BCFA19AD197A31CC34D0BD55C2CA18C60C485 │ │ │ │ │ -5993F736EF1DD2C5D2B4D50B3D498861B4DF5E7AFF614BBCA4C2E6BECC0DCEF5 │ │ │ │ │ -95F0D686188014C530D8E37650CDCAE721B4AFB0F178BC744BDDDED45DAB7FEB │ │ │ │ │ -A10B975E26099E3DC61116D6BF554574F948895B88EEFE03DCC5351190836AD4 │ │ │ │ │ -EBC1AC55C6D099A8E7B0A372D290C481F44FA464B9C11A0BC991CB045E0AAAC4 │ │ │ │ │ -5C73CA43A4F17D1ADDD33D1B917FF95BFF411C8409F41553B1BC97DE47E3A1F4 │ │ │ │ │ -A5C1D1B7B1BF7E2507AC53956C141411F4F657E37981996DD7BB7ADB2CB6AE01 │ │ │ │ │ -73D0876B8F896F626D5022FE53BA34D5668BD698BE8D5CCAD083CBCEF440BE6A │ │ │ │ │ -8090EB1CDEE5F99C8988650BD4E539B357C31C597D8A9104A9D5967D4E906CAD │ │ │ │ │ -2A65575A884B1C5F6CC509E742FA9DDD66494F219178161AF72C50848E226A95 │ │ │ │ │ -A8C247FF9FF0BABD073021271B5C0692F9BE220071DAB09E5A026629371EE3C4 │ │ │ │ │ -A6E4FA94625D87A5B66EF077ED54C72B1052AEAA9637B30C76EF8EB04AD5F476 │ │ │ │ │ -D15F1C93C0BC6E0F67B366097BBED03FE82C040F9EF02866159B46854E11D44F │ │ │ │ │ -54AE6748A7E61B993A4EECD3B8BE3B5897A66BBCDFE24F65BC2AD5AB49048CF1 │ │ │ │ │ -647203823F84DF5CB483096F9D96AEE3A2855E479B72A14A67C633CE99C101CF │ │ │ │ │ -EFAE939BF9B02E710D │ │ │ │ │ +1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004ACD1870 │ │ │ │ │ +A5EA947858F5795870BFE1343AD803FB854BF8F5A4E794E8EC57BE41DB5B8734 │ │ │ │ │ +13E47950F29A81EA0C81EA798863883D7F41F78325CA190CBBFFE822AE494550 │ │ │ │ │ +4BE83703071FC9512D128927AF3F63CEF8F86ABE1E15D7B4DDD39576E7DFF45E │ │ │ │ │ +3CB4115AAB1830DE8647B915DB4BEBEB5235C281E098B899BAB951D8D5798F01 │ │ │ │ │ +7F7C47336D31438E5126738AFEAB29E9A7CBE06DE4DD604477B542D2620DFD58 │ │ │ │ │ +28FE34238572F23C5A8EB7ACEE1E154DA13FC1A5AA67A3BA8C5CDFB2B80312C9 │ │ │ │ │ +BC9FAE56D08DDFA9498E6EF0D0F6BD18B3923E0B670B0740528BC843610736CB │ │ │ │ │ +80228C105C2F72C3C22D610C3D8C268DEEA2AEEE3221E198E79FE2966487360C │ │ │ │ │ +84AE08AC326F48B21447652121B1EB68AF856055EEA65B6B625BF622CBFC2D1C │ │ │ │ │ +EF943CC4CAF2C715782C9EF9A9BA4689BFC6B6A82F8D55795BE8111E2C7DE520 │ │ │ │ │ +367362304B6A48186C842033E715A46265A352472F4F7313248EBCD26BEA97E7 │ │ │ │ │ +B814A61D4B7ADCB5C5F21AA34E0C1269E8426DBFB511DE6E26B960456C8F8520 │ │ │ │ │ +5F0DD382289A62AF0B935EDB5B2394538C5F0EE72962D2F98F3C38CD7C027B9F │ │ │ │ │ +E230E67E40FEFBDED06B3423C9DFD669E6B5BC913E0FF75786A64A6C11D4FE89 │ │ │ │ │ +1B918DC0E953C52CFD153063CD0D2A78B43F8712243845E6F2CBA1DB610F403D │ │ │ │ │ +A98D06D95FF44C7AC029092B666A8B0DCEA95B34F5ACC10E8611BADE6A24469C │ │ │ │ │ +0C01D95BFB445FA22CD38D033E4D24E006BB9D54EE41EF7AD5AC9C299721F61A │ │ │ │ │ +F01B6EDCDF428BD9195A13C5B1027358F8A203F828A1DD9622243B2D76C6F1BA │ │ │ │ │ +9F2D7E9D4879FC668ABC750CD25415DC6CCF2257C28F78D3F9BE499CC0FF2F80 │ │ │ │ │ +2C2CD1DEFABD6668FCA76E1D629A344333E33DA24B86D2E9F8F5EE1C29974640 │ │ │ │ │ +C3E78E999BAB313400041DADDDFDBFFCC419F129A84F4D412B79E8BE4511CA00 │ │ │ │ │ +F92A4F3CDD2E51345D3965C104F06B6503445DC20224CB7606A9D7D5F9EE45E6 │ │ │ │ │ +1B2963DA96AA2AB1BA5BE29656E666E4D0E122DE58EEA68E04ED76438DA03E65 │ │ │ │ │ +B80055A86B7B2A26BAE6BBB8835E17F9696E9B3CD34571BA75C76D4D2CCC48F1 │ │ │ │ │ +7534C1EF9127E374D65D05B8072E08D6C72A0B4A35EA0DD717743C66D105CCD8 │ │ │ │ │ +7355F13E9C38C1A4351624E689ED7909100942FA0474842EE44DEC3279E1A1CD │ │ │ │ │ +8064666EB845CA7C3E906B67C0BF96A28D514DB2E4A1E4AF287350B03762A2CF │ │ │ │ │ +13B18AC3F5D2F3B74A1D50267C03EFB74B888E1D24ABEEA4A885F4D0BF14C0D8 │ │ │ │ │ +289AC79D6D98E2A2C831672FB1F3457564CD161ADC3AF610D88201AB5B0C10CB │ │ │ │ │ +5ECCC2D5C4AF39C8CB3044BF9EC791BA45D29C2B51EA0483D19822C264CE6FA3 │ │ │ │ │ +5C97F2DF5A78CB93528E99B9ED7CB121C83130C129B849B52A36EBD88AF19DD3 │ │ │ │ │ +C5CABE831027388EF86BD5CBD90AAAC089775938A321C44D4DDA67A51312D8AB │ │ │ │ │ +C509DDBE7044A107AB2BE9C4C9556F85C529B174A7778B489BF28EC07A834542 │ │ │ │ │ +8B31F2925C21FB2096877711F998763D5A8495002B8E080AF8DBB1B3106EDDBA │ │ │ │ │ +35121D52E0846A7AF3ABEDF87BDE4FA665673A9B80CA538B98F873947AA17EF4 │ │ │ │ │ +9BB182917E9D79BC7EC681E93710D6A1D6B0E4A7FA9452FC1C431808174F3AB7 │ │ │ │ │ +F3914FBC86CB34E8583457243C3C7BE4BC166C7397689BC6FFB82EA2967E88EE │ │ │ │ │ +464F96EDA144DE2B64401B8E577ABCA2D826FE0B92E21FFAE3E81EBB6B6EB36E │ │ │ │ │ +9B1A8FE3884CA398C03135FD49D51724FC1268E9482E41FAEA2FC6C809006B8F │ │ │ │ │ +5D4F9E038450AD3A6041C16FD1C7E5FC80C0E033CE57E64863E014531D94DF1E │ │ │ │ │ +31D7D038AFCB60715AA73C1E96F113A24C5AF35BBEB61C4D079ED034ED83AA4A │ │ │ │ │ +E12448E618330463304788BCF40561CD63167B3BF144F408E2B89E60B8BA13EF │ │ │ │ │ +3B57D286FD23D4FA8BAEFF98DC1188B1982956CC1DCAEFC7D949B7B4E3BE8F8A │ │ │ │ │ +BFE2C9D938DD13EFEE7123576608D9396F260907DA98AE2D3DD5822306CBC8A6 │ │ │ │ │ +B083C697DDA3C62EE7879436A9FD8EE0034B105105B3F122F893EA2126EBE8A9 │ │ │ │ │ +5CBF2BD248DD9FBEF0040C25797BD13B69A8C9F0D4E4F935C61ED30487CCDB1A │ │ │ │ │ +0339006E78EE1755929D2412776EC7DB1F666DBDD28EA8AC7397F809C7F38A41 │ │ │ │ │ +5B3BF6C75F4F35C90141EB08377AF452CF840FEA938805F9D14E02DC29215B4E │ │ │ │ │ +F1EB │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ @@ -5617,17 +5608,17 @@ │ │ │ │ │ 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 23[45 19[83 18[25 │ │ │ │ │ -2[45 2[45 1[45 45 45 3[25 44[{}10 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 │ │ │ │ │ +46[{}27 119.552 /CMBX12 rf /Fe 138[51 6[51 8[40 26[47 │ │ │ │ │ +15[25 4[45 2[45 1[45 3[25 44[{}9 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 │ │ │ │ │ @@ -5746,17 +5737,17 @@ │ │ │ │ │ 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 1179 4 v │ │ │ │ │ -1361 w Fn(Graph)29 b Fe(:)40 b Fl(DRAFT)31 b Fe(Ma)m(y)g(17,)h(2024)p │ │ │ │ │ -2721 100 V 0 399 a Fo(and)k(it)i(is)f(the)g(smallest)h(graph)e(with)h │ │ │ │ │ +TeXDict begin 2 1 bop 0 100 a Fo(2)p 136 100 1172 4 v │ │ │ │ │ +1354 w Fn(Graph)29 b Fe(:)41 b Fl(DRAFT)30 b Fe(June)f(20,)j(2025)p │ │ │ │ │ +2728 100 V 0 399 a Fo(and)k(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 │ │ │ │ │ @@ -5812,17 +5803,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 1179 4 v 1360 100 a Fn(Graph)29 │ │ │ │ │ -b Fe(:)41 b Fl(DRAFT)121 b Fe(Ma)m(y)32 b(17,)f(2024)p │ │ │ │ │ -2674 100 V 1179 w Fo(3)0 399 y Fa(1.2.1)112 b(Basic)38 │ │ │ │ │ +TeXDict begin 3 2 bop 91 100 1172 4 v 1353 100 a Fn(Graph)29 │ │ │ │ │ +b Fe(:)41 b Fl(DRAFT)121 b Fe(June)30 b(20,)h(2025)p │ │ │ │ │ +2681 100 V 1172 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 │ │ │ │ │ @@ -5889,17 +5880,17 @@ │ │ │ │ │ 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 1179 4 v │ │ │ │ │ -1361 w Fn(Graph)29 b Fe(:)40 b Fl(DRAFT)31 b Fe(Ma)m(y)g(17,)h(2024)p │ │ │ │ │ -2721 100 V 111 399 a Fo(2.)46 b Fn(void)h(Graph_init2)e(\()i(Graph)f │ │ │ │ │ +TeXDict begin 4 3 bop 0 100 a Fo(4)p 136 100 1172 4 v │ │ │ │ │ +1354 w Fn(Graph)29 b Fe(:)41 b Fl(DRAFT)30 b Fe(June)f(20,)j(2025)p │ │ │ │ │ +2728 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 │ │ │ │ │ @@ -5979,17 +5970,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 1179 4 v 1360 100 a Fn(Graph)29 │ │ │ │ │ -b Fe(:)41 b Fl(DRAFT)121 b Fe(Ma)m(y)32 b(17,)f(2024)p │ │ │ │ │ -2674 100 V 1179 w Fo(5)227 399 y Fl(Err)-5 b(or)33 b(che)-5 │ │ │ │ │ +TeXDict begin 5 4 bop 91 100 1172 4 v 1353 100 a Fn(Graph)29 │ │ │ │ │ +b Fe(:)41 b Fl(DRAFT)121 b Fe(June)30 b(20,)h(2025)p │ │ │ │ │ +2681 100 V 1172 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 │ │ │ │ │ @@ -6049,17 +6040,17 @@ │ │ │ │ │ 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 1179 4 v │ │ │ │ │ -1361 w Fn(Graph)29 b Fe(:)40 b Fl(DRAFT)31 b Fe(Ma)m(y)g(17,)h(2024)p │ │ │ │ │ -2721 100 V 111 399 a Fo(3.)46 b Fn(int)h(Graph_adjAndSize)d(\()j(Graph) │ │ │ │ │ +TeXDict begin 6 5 bop 0 100 a Fo(6)p 136 100 1172 4 v │ │ │ │ │ +1354 w Fn(Graph)29 b Fe(:)41 b Fl(DRAFT)30 b Fe(June)f(20,)j(2025)p │ │ │ │ │ +2728 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 │ │ │ │ │ @@ -6145,17 +6136,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 1179 4 v 1360 100 a Fn(Graph)29 │ │ │ │ │ -b Fe(:)41 b Fl(DRAFT)121 b Fe(Ma)m(y)32 b(17,)f(2024)p │ │ │ │ │ -2674 100 V 1179 w Fo(7)227 399 y Fl(Err)-5 b(or)32 b(che)-5 │ │ │ │ │ +TeXDict begin 7 6 bop 91 100 1172 4 v 1353 100 a Fn(Graph)29 │ │ │ │ │ +b Fe(:)41 b Fl(DRAFT)121 b Fe(June)30 b(20,)h(2025)p │ │ │ │ │ +2681 100 V 1172 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 │ │ │ │ │ @@ -6237,17 +6228,17 @@ │ │ │ │ │ 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 1179 4 v │ │ │ │ │ -1361 w Fn(Graph)29 b Fe(:)40 b Fl(DRAFT)31 b Fe(Ma)m(y)g(17,)h(2024)p │ │ │ │ │ -2721 100 V 111 399 a Fo(6.)46 b Fn(int)h(Graph_writeToBinaryFile)42 │ │ │ │ │ +TeXDict begin 8 7 bop 0 100 a Fo(8)p 136 100 1172 4 v │ │ │ │ │ +1354 w Fn(Graph)29 b Fe(:)41 b Fl(DRAFT)30 b Fe(June)f(20,)j(2025)p │ │ │ │ │ +2728 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 │ │ │ │ │ @@ -6310,17 +6301,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 1179 4 v 1360 100 a Fn(Graph)29 │ │ │ │ │ -b Fe(:)41 b Fl(DRAFT)121 b Fe(Ma)m(y)32 b(17,)f(2024)p │ │ │ │ │ -2674 100 V 1179 w Fo(9)337 399 y Fc(\210)45 b Fo(The)28 │ │ │ │ │ +TeXDict begin 9 8 bop 91 100 1172 4 v 1353 100 a Fn(Graph)29 │ │ │ │ │ +b Fe(:)41 b Fl(DRAFT)121 b Fe(June)30 b(20,)h(2025)p │ │ │ │ │ +2681 100 V 1172 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 │ │ │ │ │ @@ -6403,17 +6394,17 @@ │ │ │ │ │ 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 1156 4 │ │ │ │ │ -v 1339 w Fn(Graph)29 b Fe(:)40 b Fl(DRAFT)30 b Fe(Ma)m(y)i(17,)f(2024)p │ │ │ │ │ -2744 100 V 227 399 a Fo(This)d(driv)m(er)h(program)g(creates)h(a)f │ │ │ │ │ +TeXDict begin 10 9 bop 0 100 a Fo(10)p 182 100 1149 4 │ │ │ │ │ +v 1332 w Fn(Graph)29 b Fe(:)40 b Fl(DRAFT)30 b Fe(June)g(20,)h(2025)p │ │ │ │ │ +2751 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 │ │ │ │ │ @@ -6482,17 +6473,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 1156 4 v 1338 100 a Fn(Graph)29 │ │ │ │ │ -b Fe(:)40 b Fl(DRAFT)121 b Fe(Ma)m(y)32 b(17,)f(2024)p │ │ │ │ │ -2651 100 V 1156 w Fo(11)337 399 y Fc(\210)45 b Fo(The)37 │ │ │ │ │ +TeXDict begin 11 10 bop 91 100 1149 4 v 1331 100 a Fn(Graph)29 │ │ │ │ │ +b Fe(:)40 b Fl(DRAFT)121 b Fe(June)30 b(20,)h(2025)p │ │ │ │ │ +2658 100 V 1149 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 │ │ │ │ │ @@ -6549,18 +6540,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 1156 │ │ │ │ │ -4 v 1339 w Fn(Graph)29 b Fe(:)40 b Fl(DRAFT)30 b Fe(Ma)m(y)i(17,)f │ │ │ │ │ -(2024)p 2744 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 1149 │ │ │ │ │ +4 v 1332 w Fn(Graph)29 b Fe(:)40 b Fl(DRAFT)30 b Fe(June)g(20,)h(2025)p │ │ │ │ │ +2751 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 May 17, 2024 │ │ │ │ │ │ + 2 Graph : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 3 │ │ │ │ │ │ + Graph : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 4 Graph : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 5 │ │ │ │ │ │ + Graph : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 6 Graph : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 7 │ │ │ │ │ │ + Graph : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 8 Graph : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 9 │ │ │ │ │ │ + Graph : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 10 Graph : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 11 │ │ │ │ │ │ + Graph : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 12 Graph : DRAFT June 20, 2025 │ │ │ │ │ │ 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 2024.05.17:2218 │ │ │ │ │ +%DVIPSSource: TeX output 2025.06.20:0449 │ │ │ │ │ %%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 │ │ │ │ │ @@ -2423,22 +2423,21 @@ │ │ │ │ │ /UnderlinePosition -100 def │ │ │ │ │ /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 49 /one put │ │ │ │ │ dup 50 /two put │ │ │ │ │ -dup 52 /four put │ │ │ │ │ -dup 55 /seven put │ │ │ │ │ +dup 53 /five put │ │ │ │ │ dup 58 /colon put │ │ │ │ │ -dup 77 /M put │ │ │ │ │ -dup 97 /a put │ │ │ │ │ -dup 121 /y put │ │ │ │ │ +dup 74 /J put │ │ │ │ │ +dup 101 /e put │ │ │ │ │ +dup 110 /n put │ │ │ │ │ +dup 117 /u put │ │ │ │ │ readonly def │ │ │ │ │ currentdict end │ │ │ │ │ currentfile eexec │ │ │ │ │ D9D66F633B846AB284BCF8B0411B772DE5CE32340DC6F28AF40857E4451976E7 │ │ │ │ │ 5182433CF9F333A38BD841C0D4E68BF9E012EB32A8FFB76B5816306B5EDF7C99 │ │ │ │ │ 8B3A16D9B4BC056662E32C7CD0123DFAEB734C7532E64BBFBF5A60336E646716 │ │ │ │ │ EFB852C877F440D329172C71F1E5D59CE9473C26B8AEF7AD68EF0727B6EC2E0C │ │ │ │ │ @@ -2619,72 +2618,64 @@ │ │ │ │ │ 7CA1534C4D5B05FC33F83790ECFD7641DF3FB94289E2A1F6E7D29AB1228A867A │ │ │ │ │ 6E1EF0E9C6F899B491DC18401C2C0A05FFFED46A72C245F7529B8EA55A038082 │ │ │ │ │ 8512307217D2A233C37004085BA3AEE379269F9FA7D0ADB4B19A95CC2AFE686E │ │ │ │ │ 55D88E47257C1FE6F235FEA295910569FE6DD5995512562359CC821E85A6C7A5 │ │ │ │ │ 79B470A9E340A6985189FF8B6AF914A6B0ECF93F47903221F95DE894A8F05B05 │ │ │ │ │ B7D99CD533EC5F931B18E6B39BECF67FA2D6DD1AEC76772B068BE06335A94C05 │ │ │ │ │ 7A4DDEE77B66101DA855C17AC312600370B34E31F5EC3A01300A8EB60B4C9767 │ │ │ │ │ -1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004B9BA1CC │ │ │ │ │ -580D3C6BDA4DC1B80B4365F1C80512453FC5316EC2D928FB731C3D6403E3C18B │ │ │ │ │ -E8424D644DF5E9A2134229C5C91CA68DB8E85BA2BB40F538F585DA6FA4037718 │ │ │ │ │ -B8053EBBA1E765346BCD5BDAA6C38115D31611D8A87A2238C145F2DA2F92E4DF │ │ │ │ │ -3987BD9C4D2A3D460E8941A68B125BCD9EE4F9FD262C4C8A71F47A2C81975635 │ │ │ │ │ -F1B981C274C53FA2ACCDE4C9D0A7C62D6C1EFF91CFC6712CA6A9F333C9564FCB │ │ │ │ │ -2A70F0AD715A79B10A08AB069E2A3C93BC0AED19D0CA10134B8DDDE8AF548DB2 │ │ │ │ │ -3A4AAA9C29682CF135BB767DAA16169A127EB50A7EECEB6480CF56A7D0F8AC56 │ │ │ │ │ -4A5090B3D75A790372886AF568D94C8165975A05BFBFDF1FFBA45F70700BB9E0 │ │ │ │ │ -57F3249EF9E9C8AD9CBCF6E4FD592DC4CDD2CC7C0BC3130C1059096C657BE453 │ │ │ │ │ -A2CBACE93420210E27AF56CA229BD6D982FB68B3FDC6D44478B922C4231C47EE │ │ │ │ │ -E500232F6C11D92DEB955F66DF52B92B22E7352790CC2DCBAC53965D57AC2920 │ │ │ │ │ -68B7D520DE25047146EFEB06B9AD4E2A94243C7E5239F0BC2FC312B16051D52C │ │ │ │ │ -0B92C217B6B42997321AE4F8BB066754B7AA3F15069EF59224E8A442CE471AA7 │ │ │ │ │ -E8049A3DD9EDA09CCEE4998998661CF7DB35E952F6C65DAEB3013951C59F3E09 │ │ │ │ │ -157F313B0237876E1C0190F0473819570B8C0205AADF05D787CC00979CFB327A │ │ │ │ │ -289382B22DDA6F12804ED0ED5B179E36A995A2A59E1B66E75130DBE9109C813B │ │ │ │ │ -94403E0DEA8314A1E9DB474D7FA83C0BAFD08033E6A6215844C1D26BE15F1251 │ │ │ │ │ -A1605E8DF9A9C601ED37379530BC1C82BE5463C6C711C5652BFD6262485AA9CA │ │ │ │ │ -B8C4A117593001D08D980041E2A83C190DCE8E6CD3D334E5CC19FC05DB30F7F7 │ │ │ │ │ -24A305C4DBB31F0651392B99D44B4302333BDF7E326FD256DD75D309C6E73F85 │ │ │ │ │ -FA71B35FD1F9BEFF4C7A1076362EEB0A85492933B6006086A7B8C1928CF2D1EE │ │ │ │ │ -FD4344409257BB802C117E739960821CD3C88BFBA5669FF16F610AD638AF3677 │ │ │ │ │ -8674C985E6767253ED5769F71BEA5E9BB02A751F9E62EE2B18AC19D975FDEAE9 │ │ │ │ │ -8B8822367FF177A7E850766DE99ED3366D46464612926430012212A90F8E85F4 │ │ │ │ │ -4760B40D5B86B90819EE410382C23E86DCAF4F0FF5DFEB2C285965F4DCF2FB2B │ │ │ │ │ -457C0A0427A8D4ADA514E9DACD0F9367E1DA225DB21DA4DDAE33F2B529686D92 │ │ │ │ │ -AC085B345565F9DFFA012FD494DBB2E0B44A0787B2B72DC8D25399DAAE8864B7 │ │ │ │ │ -E84AA99DAFCEAF18F8B41882720316450F1B1CA48B418C9736E5CE4AFF996111 │ │ │ │ │ -5F7FE80958B6A3498508E9693CB134402D92E30D4C2939070D4647E13682290E │ │ │ │ │ -1D0820A3FCA7147157D09D1A40771F214EAE7DD743EA26839E535CA186C05CB8 │ │ │ │ │ -4874988AA1104D85AF0220FE7224344FF624E794BD2454E1C0AC971522FBECBA │ │ │ │ │ -B2497F25CD621B77EC5160973EF5ECC39C183DC051B0DFCB090194A2525BD96E │ │ │ │ │ -28593FDA80D8D259F039416D5F9AF0AD3C9A105B49DAF6E681921E369B7666C6 │ │ │ │ │ -2B73DB37447B00AE96317C2F1C44FB6E6EFD740BAB20FA03A8CE018EC8415582 │ │ │ │ │ -FB06E88A2971E3A480FB1EB4FE93CC7E5179721CAABEE88742B13CF0405F49F4 │ │ │ │ │ -945E587668C821D8C06D6847B6DF84CAFFCD4628670D551FC5F7236875BE1207 │ │ │ │ │ -634BA7F70A19B658FAE7D86F6D00ED28FBF29CC585DEE279325EEF8B0CCB6149 │ │ │ │ │ -E46E638C73D75148F18A636DBC2DD96ED34F68A5A09A3700B1EA34B2D142807C │ │ │ │ │ -F8709D81180783548EAE6F457BF968602076A1069163E3C15BBCEF659C6CF2E6 │ │ │ │ │ -0BB01BDC8E503802CC7969A5B8477E9788C5249B23B19669F5075E089738E49A │ │ │ │ │ -8671D7C1B1B47652F3D78BF2FF74EDB44BA5B092E8D5B85001E97F69D54AEEFC │ │ │ │ │ -88FC3CA1B0D5BAC39263B371005BCFA19AD197A31CC34D0BD55C2CA18C60C485 │ │ │ │ │ -5993F736EF1DD2C5D2B4D50B3D498861B4DF5E7AFF614BBCA4C2E6BECC0DCEF5 │ │ │ │ │ -95F0D686188014C530D8E37650CDCAE721B4AFB0F178BC744BDDDED45DAB7FEB │ │ │ │ │ -A10B975E26099E3DC61116D6BF554574F948895B88EEFE03DCC5351190836AD4 │ │ │ │ │ -EBC1AC55C6D099A8E7B0A372D290C481F44FA464B9C11A0BC991CB045E0AAAC4 │ │ │ │ │ -5C73CA43A4F17D1ADDD33D1B917FF95BFF411C8409F41553B1BC97DE47E3A1F4 │ │ │ │ │ -A5C1D1B7B1BF7E2507AC53956C141411F4F657E37981996DD7BB7ADB2CB6AE01 │ │ │ │ │ -73D0876B8F896F626D5022FE53BA34D5668BD698BE8D5CCAD083CBCEF440BE6A │ │ │ │ │ -8090EB1CDEE5F99C8988650BD4E539B357C31C597D8A9104A9D5967D4E906CAD │ │ │ │ │ -2A65575A884B1C5F6CC509E742FA9DDD66494F219178161AF72C50848E226A95 │ │ │ │ │ -A8C247FF9FF0BABD073021271B5C0692F9BE220071DAB09E5A026629371EE3C4 │ │ │ │ │ -A6E4FA94625D87A5B66EF077ED54C72B1052AEAA9637B30C76EF8EB04AD5F476 │ │ │ │ │ -D15F1C93C0BC6E0F67B366097BBED03FE82C040F9EF02866159B46854E11D44F │ │ │ │ │ -54AE6748A7E61B993A4EECD3B8BE3B5897A66BBCDFE24F65BC2AD5AB49048CF1 │ │ │ │ │ -647203823F84DF5CB483096F9D96AEE3A2855E479B72A14A67C633CE99C101CF │ │ │ │ │ -EFAE939BF9B02E710D │ │ │ │ │ +1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004ACD1870 │ │ │ │ │ +A5EA947858F5795870BFE1343AD803FB854BF8F5A4E794E8EC57BE41DB5B8734 │ │ │ │ │ +13E47950F29A81EA0C81EA798863883D7F41F78325CA190CBBFFE822AE494550 │ │ │ │ │ +4BE83703071FC9512D128927AF3F63CEF8F86ABE1E15D7B4DDD39576E7DFF45E │ │ │ │ │ +3CB4115AAB1830DE8647B915DB4BEBEB5235C281E098B899BAB951D8D5798F01 │ │ │ │ │ +7F7C47336D31438E5126738AFEAB29E9A7CBE06DE4DD604477B542D2620DFD58 │ │ │ │ │ +28FE34238572F23C5A8EB7ACEE1E154DA13FC1A5AA67A3BA8C5CDFB2B80312C9 │ │ │ │ │ +BC9FAE56D08DDFA9498E6EF0D0F6BD18B3923E0B670B0740528BC843610736CB │ │ │ │ │ +80228C105C2F72C3C22D610C3D8C268DEEA2AEEE3221E198E79FE2966487360C │ │ │ │ │ +84AE08AC326F48B21447652121B1EB68AF856055EEA65B6B625BF622CBFC2D1C │ │ │ │ │ +EF943CC4CAF2C715782C9EF9A9BA4689BFC6B6A82F8D55795BE8111E2C7DE520 │ │ │ │ │ +367362304B6A48186C842033E715A46265A352472F4F7313248EBCD26BEA97E7 │ │ │ │ │ +B814A61D4B7ADCB5C5F21AA34E0C1269E8426DBFB511DE6E26B960456C8F8520 │ │ │ │ │ +5F0DD382289A62AF0B935EDB5B2394538C5F0EE72962D2F98F3C38CD7C027B9F │ │ │ │ │ +E230E67E40FEFBDED06B3423C9DFD669E6B5BC913E0FF75786A64A6C11D4FE89 │ │ │ │ │ +1B918DC0E953C52CFD153063CD0D2A78B43F8712243845E6F2CBA1DB610F403D │ │ │ │ │ +A98D06D95FF44C7AC029092B666A8B0DCEA95B34F5ACC10E8611BADE6A24469C │ │ │ │ │ +0C01D95BFB445FA22CD38D033E4D24E006BB9D54EE41EF7AD5AC9C299721F61A │ │ │ │ │ +F01B6EDCDF428BD9195A13C5B1027358F8A203F828A1DD9622243B2D76C6F1BA │ │ │ │ │ +9F2D7E9D4879FC668ABC750CD25415DC6CCF2257C28F78D3F9BE499CC0FF2F80 │ │ │ │ │ +2C2CD1DEFABD6668FCA76E1D629A344333E33DA24B86D2E9F8F5EE1C29974640 │ │ │ │ │ +C3E78E999BAB313400041DADDDFDBFFCC419F129A84F4D412B79E8BE4511CA00 │ │ │ │ │ +F92A4F3CDD2E51345D3965C104F06B6503445DC20224CB7606A9D7D5F9EE45E6 │ │ │ │ │ +1B2963DA96AA2AB1BA5BE29656E666E4D0E122DE58EEA68E04ED76438DA03E65 │ │ │ │ │ +B80055A86B7B2A26BAE6BBB8835E17F9696E9B3CD34571BA75C76D4D2CCC48F1 │ │ │ │ │ +7534C1EF9127E374D65D05B8072E08D6C72A0B4A35EA0DD717743C66D105CCD8 │ │ │ │ │ +7355F13E9C38C1A4351624E689ED7909100942FA0474842EE44DEC3279E1A1CD │ │ │ │ │ +8064666EB845CA7C3E906B67C0BF96A28D514DB2E4A1E4AF287350B03762A2CF │ │ │ │ │ +13B18AC3F5D2F3B74A1D50267C03EFB74B888E1D24ABEEA4A885F4D0BF14C0D8 │ │ │ │ │ +289AC79D6D98E2A2C831672FB1F3457564CD161ADC3AF610D88201AB5B0C10CB │ │ │ │ │ +5ECCC2D5C4AF39C8CB3044BF9EC791BA45D29C2B51EA0483D19822C264CE6FA3 │ │ │ │ │ +5C97F2DF5A78CB93528E99B9ED7CB121C83130C129B849B52A36EBD88AF19DD3 │ │ │ │ │ +C5CABE831027388EF86BD5CBD90AAAC089775938A321C44D4DDA67A51312D8AB │ │ │ │ │ +C509DDBE7044A107AB2BE9C4C9556F85C529B174A7778B489BF28EC07A834542 │ │ │ │ │ +8B31F2925C21FB2096877711F998763D5A8495002B8E080AF8DBB1B3106EDDBA │ │ │ │ │ +35121D52E0846A7AF3ABEDF87BDE4FA665673A9B80CA538B98F873947AA17EF4 │ │ │ │ │ +9BB182917E9D79BC7EC681E93710D6A1D6B0E4A7FA9452FC1C431808174F3AB7 │ │ │ │ │ +F3914FBC86CB34E8583457243C3C7BE4BC166C7397689BC6FFB82EA2967E88EE │ │ │ │ │ +464F96EDA144DE2B64401B8E577ABCA2D826FE0B92E21FFAE3E81EBB6B6EB36E │ │ │ │ │ +9B1A8FE3884CA398C03135FD49D51724FC1268E9482E41FAEA2FC6C809006B8F │ │ │ │ │ +5D4F9E038450AD3A6041C16FD1C7E5FC80C0E033CE57E64863E014531D94DF1E │ │ │ │ │ +31D7D038AFCB60715AA73C1E96F113A24C5AF35BBEB61C4D079ED034ED83AA4A │ │ │ │ │ +E12448E618330463304788BCF40561CD63167B3BF144F408E2B89E60B8BA13EF │ │ │ │ │ +3B57D286FD23D4FA8BAEFF98DC1188B1982956CC1DCAEFC7D949B7B4E3BE8F8A │ │ │ │ │ +BFE2C9D938DD13EFEE7123576608D9396F260907DA98AE2D3DD5822306CBC8A6 │ │ │ │ │ +B083C697DDA3C62EE7879436A9FD8EE0034B105105B3F122F893EA2126EBE8A9 │ │ │ │ │ +5CBF2BD248DD9FBEF0040C25797BD13B69A8C9F0D4E4F935C61ED30487CCDB1A │ │ │ │ │ +0339006E78EE1755929D2412776EC7DB1F666DBDD28EA8AC7397F809C7F38A41 │ │ │ │ │ +5B3BF6C75F4F35C90141EB08377AF452CF840FEA938805F9D14E02DC29215B4E │ │ │ │ │ +F1EB │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ @@ -4328,21 +4319,21 @@ │ │ │ │ │ @start /Fa 150[31 43[45 61[{}2 90.9091 /CMMI10 rf /Fb │ │ │ │ │ 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 23[45 │ │ │ │ │ -19[83 18[25 2[45 2[45 1[45 45 45 3[25 44[{}10 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 │ │ │ │ │ +5[62 22[62 50[{}12 119.552 /CMTT12 rf /Fh 138[51 6[51 │ │ │ │ │ +8[40 26[47 15[25 4[45 2[45 1[45 3[25 44[{}9 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 │ │ │ │ │ /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 │ │ │ │ │ @@ -4450,17 +4441,17 @@ │ │ │ │ │ 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 1131 4 v │ │ │ │ │ -1313 w Fl(I2Ohash)29 b Fh(:)40 b Fi(DRAFT)30 b Fh(Ma)m(y)i(17,)f(2024)p │ │ │ │ │ -2769 100 V 137 399 a Fk(\210)45 b Fl(I2OP)i(*freeI2OP)28 │ │ │ │ │ +TeXDict begin 2 1 bop 0 100 a Fm(2)p 136 100 1124 4 v │ │ │ │ │ +1306 w Fl(I2Ohash)29 b Fh(:)40 b Fi(DRAFT)30 b Fh(June)g(20,)h(2025)p │ │ │ │ │ +2776 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 │ │ │ │ │ @@ -4510,17 +4501,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 1131 4 v 1313 100 a Fl(I2Ohash)28 │ │ │ │ │ -b Fh(:)41 b Fi(DRAFT)121 b Fh(Ma)m(y)31 b(17,)h(2024)p │ │ │ │ │ -2722 100 V 1131 w Fm(3)111 399 y(1.)46 b Fl(void)h(I2Ohash_init)d(\()k │ │ │ │ │ +TeXDict begin 3 2 bop 91 100 1124 4 v 1306 100 a Fl(I2Ohash)28 │ │ │ │ │ +b Fh(:)41 b Fi(DRAFT)121 b Fh(June)29 b(20,)j(2025)p │ │ │ │ │ +2729 100 V 1124 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 │ │ │ │ │ @@ -4596,17 +4587,17 @@ │ │ │ │ │ (*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 1131 4 v │ │ │ │ │ -1313 w Fl(I2Ohash)29 b Fh(:)40 b Fi(DRAFT)30 b Fh(Ma)m(y)i(17,)f(2024)p │ │ │ │ │ -2769 100 V 0 399 a Fj(1.3)135 b(Driv)l(er)46 b(programs)g(for)f(the)g │ │ │ │ │ +TeXDict begin 4 3 bop 0 100 a Fm(4)p 136 100 1124 4 v │ │ │ │ │ +1306 w Fl(I2Ohash)29 b Fh(:)40 b Fi(DRAFT)30 b Fh(June)g(20,)h(2025)p │ │ │ │ │ +2776 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 │ │ │ │ │ ├── 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 May 17, 2024 │ │ │ │ │ │ + 2 I2Ohash : DRAFT June 20, 2025 │ │ │ │ │ │ • 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 May 17, 2024 3 │ │ │ │ │ │ + I2Ohash : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 4 I2Ohash : DRAFT June 20, 2025 │ │ │ │ │ │ 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 2024.05.17:2218 │ │ │ │ │ +%DVIPSSource: TeX output 2025.06.20:0449 │ │ │ │ │ %%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 │ │ │ │ │ @@ -1276,22 +1276,21 @@ │ │ │ │ │ /UnderlinePosition -100 def │ │ │ │ │ /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 49 /one put │ │ │ │ │ dup 50 /two put │ │ │ │ │ -dup 52 /four put │ │ │ │ │ -dup 55 /seven put │ │ │ │ │ +dup 53 /five put │ │ │ │ │ dup 58 /colon put │ │ │ │ │ -dup 77 /M put │ │ │ │ │ -dup 97 /a put │ │ │ │ │ -dup 121 /y put │ │ │ │ │ +dup 74 /J put │ │ │ │ │ +dup 101 /e put │ │ │ │ │ +dup 110 /n put │ │ │ │ │ +dup 117 /u put │ │ │ │ │ readonly def │ │ │ │ │ currentdict end │ │ │ │ │ currentfile eexec │ │ │ │ │ D9D66F633B846AB284BCF8B0411B772DE5CE32340DC6F28AF40857E4451976E7 │ │ │ │ │ 5182433CF9F333A38BD841C0D4E68BF9E012EB32A8FFB76B5816306B5EDF7C99 │ │ │ │ │ 8B3A16D9B4BC056662E32C7CD0123DFAEB734C7532E64BBFBF5A60336E646716 │ │ │ │ │ EFB852C877F440D329172C71F1E5D59CE9473C26B8AEF7AD68EF0727B6EC2E0C │ │ │ │ │ @@ -1472,72 +1471,64 @@ │ │ │ │ │ 7CA1534C4D5B05FC33F83790ECFD7641DF3FB94289E2A1F6E7D29AB1228A867A │ │ │ │ │ 6E1EF0E9C6F899B491DC18401C2C0A05FFFED46A72C245F7529B8EA55A038082 │ │ │ │ │ 8512307217D2A233C37004085BA3AEE379269F9FA7D0ADB4B19A95CC2AFE686E │ │ │ │ │ 55D88E47257C1FE6F235FEA295910569FE6DD5995512562359CC821E85A6C7A5 │ │ │ │ │ 79B470A9E340A6985189FF8B6AF914A6B0ECF93F47903221F95DE894A8F05B05 │ │ │ │ │ B7D99CD533EC5F931B18E6B39BECF67FA2D6DD1AEC76772B068BE06335A94C05 │ │ │ │ │ 7A4DDEE77B66101DA855C17AC312600370B34E31F5EC3A01300A8EB60B4C9767 │ │ │ │ │ -1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004B9BA1CC │ │ │ │ │ -580D3C6BDA4DC1B80B4365F1C80512453FC5316EC2D928FB731C3D6403E3C18B │ │ │ │ │ -E8424D644DF5E9A2134229C5C91CA68DB8E85BA2BB40F538F585DA6FA4037718 │ │ │ │ │ -B8053EBBA1E765346BCD5BDAA6C38115D31611D8A87A2238C145F2DA2F92E4DF │ │ │ │ │ -3987BD9C4D2A3D460E8941A68B125BCD9EE4F9FD262C4C8A71F47A2C81975635 │ │ │ │ │ -F1B981C274C53FA2ACCDE4C9D0A7C62D6C1EFF91CFC6712CA6A9F333C9564FCB │ │ │ │ │ -2A70F0AD715A79B10A08AB069E2A3C93BC0AED19D0CA10134B8DDDE8AF548DB2 │ │ │ │ │ -3A4AAA9C29682CF135BB767DAA16169A127EB50A7EECEB6480CF56A7D0F8AC56 │ │ │ │ │ -4A5090B3D75A790372886AF568D94C8165975A05BFBFDF1FFBA45F70700BB9E0 │ │ │ │ │ -57F3249EF9E9C8AD9CBCF6E4FD592DC4CDD2CC7C0BC3130C1059096C657BE453 │ │ │ │ │ -A2CBACE93420210E27AF56CA229BD6D982FB68B3FDC6D44478B922C4231C47EE │ │ │ │ │ -E500232F6C11D92DEB955F66DF52B92B22E7352790CC2DCBAC53965D57AC2920 │ │ │ │ │ -68B7D520DE25047146EFEB06B9AD4E2A94243C7E5239F0BC2FC312B16051D52C │ │ │ │ │ -0B92C217B6B42997321AE4F8BB066754B7AA3F15069EF59224E8A442CE471AA7 │ │ │ │ │ -E8049A3DD9EDA09CCEE4998998661CF7DB35E952F6C65DAEB3013951C59F3E09 │ │ │ │ │ -157F313B0237876E1C0190F0473819570B8C0205AADF05D787CC00979CFB327A │ │ │ │ │ -289382B22DDA6F12804ED0ED5B179E36A995A2A59E1B66E75130DBE9109C813B │ │ │ │ │ -94403E0DEA8314A1E9DB474D7FA83C0BAFD08033E6A6215844C1D26BE15F1251 │ │ │ │ │ -A1605E8DF9A9C601ED37379530BC1C82BE5463C6C711C5652BFD6262485AA9CA │ │ │ │ │ -B8C4A117593001D08D980041E2A83C190DCE8E6CD3D334E5CC19FC05DB30F7F7 │ │ │ │ │ -24A305C4DBB31F0651392B99D44B4302333BDF7E326FD256DD75D309C6E73F85 │ │ │ │ │ -FA71B35FD1F9BEFF4C7A1076362EEB0A85492933B6006086A7B8C1928CF2D1EE │ │ │ │ │ -FD4344409257BB802C117E739960821CD3C88BFBA5669FF16F610AD638AF3677 │ │ │ │ │ -8674C985E6767253ED5769F71BEA5E9BB02A751F9E62EE2B18AC19D975FDEAE9 │ │ │ │ │ -8B8822367FF177A7E850766DE99ED3366D46464612926430012212A90F8E85F4 │ │ │ │ │ -4760B40D5B86B90819EE410382C23E86DCAF4F0FF5DFEB2C285965F4DCF2FB2B │ │ │ │ │ -457C0A0427A8D4ADA514E9DACD0F9367E1DA225DB21DA4DDAE33F2B529686D92 │ │ │ │ │ -AC085B345565F9DFFA012FD494DBB2E0B44A0787B2B72DC8D25399DAAE8864B7 │ │ │ │ │ -E84AA99DAFCEAF18F8B41882720316450F1B1CA48B418C9736E5CE4AFF996111 │ │ │ │ │ -5F7FE80958B6A3498508E9693CB134402D92E30D4C2939070D4647E13682290E │ │ │ │ │ -1D0820A3FCA7147157D09D1A40771F214EAE7DD743EA26839E535CA186C05CB8 │ │ │ │ │ -4874988AA1104D85AF0220FE7224344FF624E794BD2454E1C0AC971522FBECBA │ │ │ │ │ -B2497F25CD621B77EC5160973EF5ECC39C183DC051B0DFCB090194A2525BD96E │ │ │ │ │ -28593FDA80D8D259F039416D5F9AF0AD3C9A105B49DAF6E681921E369B7666C6 │ │ │ │ │ -2B73DB37447B00AE96317C2F1C44FB6E6EFD740BAB20FA03A8CE018EC8415582 │ │ │ │ │ -FB06E88A2971E3A480FB1EB4FE93CC7E5179721CAABEE88742B13CF0405F49F4 │ │ │ │ │ -945E587668C821D8C06D6847B6DF84CAFFCD4628670D551FC5F7236875BE1207 │ │ │ │ │ -634BA7F70A19B658FAE7D86F6D00ED28FBF29CC585DEE279325EEF8B0CCB6149 │ │ │ │ │ -E46E638C73D75148F18A636DBC2DD96ED34F68A5A09A3700B1EA34B2D142807C │ │ │ │ │ -F8709D81180783548EAE6F457BF968602076A1069163E3C15BBCEF659C6CF2E6 │ │ │ │ │ -0BB01BDC8E503802CC7969A5B8477E9788C5249B23B19669F5075E089738E49A │ │ │ │ │ -8671D7C1B1B47652F3D78BF2FF74EDB44BA5B092E8D5B85001E97F69D54AEEFC │ │ │ │ │ -88FC3CA1B0D5BAC39263B371005BCFA19AD197A31CC34D0BD55C2CA18C60C485 │ │ │ │ │ -5993F736EF1DD2C5D2B4D50B3D498861B4DF5E7AFF614BBCA4C2E6BECC0DCEF5 │ │ │ │ │ -95F0D686188014C530D8E37650CDCAE721B4AFB0F178BC744BDDDED45DAB7FEB │ │ │ │ │ -A10B975E26099E3DC61116D6BF554574F948895B88EEFE03DCC5351190836AD4 │ │ │ │ │ -EBC1AC55C6D099A8E7B0A372D290C481F44FA464B9C11A0BC991CB045E0AAAC4 │ │ │ │ │ -5C73CA43A4F17D1ADDD33D1B917FF95BFF411C8409F41553B1BC97DE47E3A1F4 │ │ │ │ │ -A5C1D1B7B1BF7E2507AC53956C141411F4F657E37981996DD7BB7ADB2CB6AE01 │ │ │ │ │ -73D0876B8F896F626D5022FE53BA34D5668BD698BE8D5CCAD083CBCEF440BE6A │ │ │ │ │ -8090EB1CDEE5F99C8988650BD4E539B357C31C597D8A9104A9D5967D4E906CAD │ │ │ │ │ -2A65575A884B1C5F6CC509E742FA9DDD66494F219178161AF72C50848E226A95 │ │ │ │ │ -A8C247FF9FF0BABD073021271B5C0692F9BE220071DAB09E5A026629371EE3C4 │ │ │ │ │ -A6E4FA94625D87A5B66EF077ED54C72B1052AEAA9637B30C76EF8EB04AD5F476 │ │ │ │ │ -D15F1C93C0BC6E0F67B366097BBED03FE82C040F9EF02866159B46854E11D44F │ │ │ │ │ -54AE6748A7E61B993A4EECD3B8BE3B5897A66BBCDFE24F65BC2AD5AB49048CF1 │ │ │ │ │ -647203823F84DF5CB483096F9D96AEE3A2855E479B72A14A67C633CE99C101CF │ │ │ │ │ -EFAE939BF9B02E710D │ │ │ │ │ +1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004ACD1870 │ │ │ │ │ +A5EA947858F5795870BFE1343AD803FB854BF8F5A4E794E8EC57BE41DB5B8734 │ │ │ │ │ +13E47950F29A81EA0C81EA798863883D7F41F78325CA190CBBFFE822AE494550 │ │ │ │ │ +4BE83703071FC9512D128927AF3F63CEF8F86ABE1E15D7B4DDD39576E7DFF45E │ │ │ │ │ +3CB4115AAB1830DE8647B915DB4BEBEB5235C281E098B899BAB951D8D5798F01 │ │ │ │ │ +7F7C47336D31438E5126738AFEAB29E9A7CBE06DE4DD604477B542D2620DFD58 │ │ │ │ │ +28FE34238572F23C5A8EB7ACEE1E154DA13FC1A5AA67A3BA8C5CDFB2B80312C9 │ │ │ │ │ +BC9FAE56D08DDFA9498E6EF0D0F6BD18B3923E0B670B0740528BC843610736CB │ │ │ │ │ +80228C105C2F72C3C22D610C3D8C268DEEA2AEEE3221E198E79FE2966487360C │ │ │ │ │ +84AE08AC326F48B21447652121B1EB68AF856055EEA65B6B625BF622CBFC2D1C │ │ │ │ │ +EF943CC4CAF2C715782C9EF9A9BA4689BFC6B6A82F8D55795BE8111E2C7DE520 │ │ │ │ │ +367362304B6A48186C842033E715A46265A352472F4F7313248EBCD26BEA97E7 │ │ │ │ │ +B814A61D4B7ADCB5C5F21AA34E0C1269E8426DBFB511DE6E26B960456C8F8520 │ │ │ │ │ +5F0DD382289A62AF0B935EDB5B2394538C5F0EE72962D2F98F3C38CD7C027B9F │ │ │ │ │ +E230E67E40FEFBDED06B3423C9DFD669E6B5BC913E0FF75786A64A6C11D4FE89 │ │ │ │ │ +1B918DC0E953C52CFD153063CD0D2A78B43F8712243845E6F2CBA1DB610F403D │ │ │ │ │ +A98D06D95FF44C7AC029092B666A8B0DCEA95B34F5ACC10E8611BADE6A24469C │ │ │ │ │ +0C01D95BFB445FA22CD38D033E4D24E006BB9D54EE41EF7AD5AC9C299721F61A │ │ │ │ │ +F01B6EDCDF428BD9195A13C5B1027358F8A203F828A1DD9622243B2D76C6F1BA │ │ │ │ │ +9F2D7E9D4879FC668ABC750CD25415DC6CCF2257C28F78D3F9BE499CC0FF2F80 │ │ │ │ │ +2C2CD1DEFABD6668FCA76E1D629A344333E33DA24B86D2E9F8F5EE1C29974640 │ │ │ │ │ +C3E78E999BAB313400041DADDDFDBFFCC419F129A84F4D412B79E8BE4511CA00 │ │ │ │ │ +F92A4F3CDD2E51345D3965C104F06B6503445DC20224CB7606A9D7D5F9EE45E6 │ │ │ │ │ +1B2963DA96AA2AB1BA5BE29656E666E4D0E122DE58EEA68E04ED76438DA03E65 │ │ │ │ │ +B80055A86B7B2A26BAE6BBB8835E17F9696E9B3CD34571BA75C76D4D2CCC48F1 │ │ │ │ │ +7534C1EF9127E374D65D05B8072E08D6C72A0B4A35EA0DD717743C66D105CCD8 │ │ │ │ │ +7355F13E9C38C1A4351624E689ED7909100942FA0474842EE44DEC3279E1A1CD │ │ │ │ │ +8064666EB845CA7C3E906B67C0BF96A28D514DB2E4A1E4AF287350B03762A2CF │ │ │ │ │ +13B18AC3F5D2F3B74A1D50267C03EFB74B888E1D24ABEEA4A885F4D0BF14C0D8 │ │ │ │ │ +289AC79D6D98E2A2C831672FB1F3457564CD161ADC3AF610D88201AB5B0C10CB │ │ │ │ │ +5ECCC2D5C4AF39C8CB3044BF9EC791BA45D29C2B51EA0483D19822C264CE6FA3 │ │ │ │ │ +5C97F2DF5A78CB93528E99B9ED7CB121C83130C129B849B52A36EBD88AF19DD3 │ │ │ │ │ +C5CABE831027388EF86BD5CBD90AAAC089775938A321C44D4DDA67A51312D8AB │ │ │ │ │ +C509DDBE7044A107AB2BE9C4C9556F85C529B174A7778B489BF28EC07A834542 │ │ │ │ │ +8B31F2925C21FB2096877711F998763D5A8495002B8E080AF8DBB1B3106EDDBA │ │ │ │ │ +35121D52E0846A7AF3ABEDF87BDE4FA665673A9B80CA538B98F873947AA17EF4 │ │ │ │ │ +9BB182917E9D79BC7EC681E93710D6A1D6B0E4A7FA9452FC1C431808174F3AB7 │ │ │ │ │ +F3914FBC86CB34E8583457243C3C7BE4BC166C7397689BC6FFB82EA2967E88EE │ │ │ │ │ +464F96EDA144DE2B64401B8E577ABCA2D826FE0B92E21FFAE3E81EBB6B6EB36E │ │ │ │ │ +9B1A8FE3884CA398C03135FD49D51724FC1268E9482E41FAEA2FC6C809006B8F │ │ │ │ │ +5D4F9E038450AD3A6041C16FD1C7E5FC80C0E033CE57E64863E014531D94DF1E │ │ │ │ │ +31D7D038AFCB60715AA73C1E96F113A24C5AF35BBEB61C4D079ED034ED83AA4A │ │ │ │ │ +E12448E618330463304788BCF40561CD63167B3BF144F408E2B89E60B8BA13EF │ │ │ │ │ +3B57D286FD23D4FA8BAEFF98DC1188B1982956CC1DCAEFC7D949B7B4E3BE8F8A │ │ │ │ │ +BFE2C9D938DD13EFEE7123576608D9396F260907DA98AE2D3DD5822306CBC8A6 │ │ │ │ │ +B083C697DDA3C62EE7879436A9FD8EE0034B105105B3F122F893EA2126EBE8A9 │ │ │ │ │ +5CBF2BD248DD9FBEF0040C25797BD13B69A8C9F0D4E4F935C61ED30487CCDB1A │ │ │ │ │ +0339006E78EE1755929D2412776EC7DB1F666DBDD28EA8AC7397F809C7F38A41 │ │ │ │ │ +5B3BF6C75F4F35C90141EB08377AF452CF840FEA938805F9D14E02DC29215B4E │ │ │ │ │ +F1EB │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ @@ -3707,17 +3698,17 @@ │ │ │ │ │ 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 23[45 19[83 18[25 2[45 2[45 1[45 45 45 3[25 │ │ │ │ │ -44[{}10 90.9091 /CMSL10 rf /Fd 143[62 7[62 2[62 3[62 │ │ │ │ │ -23[62 73[{}5 119.552 /CMTT12 rf │ │ │ │ │ +/Fc 138[51 6[51 8[40 26[47 15[25 4[45 2[45 1[45 3[25 │ │ │ │ │ +44[{}9 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 │ │ │ │ │ {/.notdef}repeat/dollar/.notdef/.notdef/quotesingle/.notdef/.notdef │ │ │ │ │ @@ -3823,17 +3814,17 @@ │ │ │ │ │ 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 1155 4 v │ │ │ │ │ -1337 w Fj(IIheap)29 b Fc(:)40 b Fi(DRAFT)31 b Fc(Ma)m(y)g(17,)h(2024)p │ │ │ │ │ -2745 100 V 0 399 a Fb(1.2.1)112 b(Basic)38 b(metho)s(ds)0 │ │ │ │ │ +TeXDict begin 2 1 bop 0 100 a Fk(2)p 136 100 1148 4 v │ │ │ │ │ +1330 w Fj(IIheap)29 b Fc(:)40 b Fi(DRAFT)31 b Fc(June)e(20,)i(2025)p │ │ │ │ │ +2752 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 │ │ │ │ │ @@ -3883,17 +3874,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 1155 4 v 1337 100 a Fj(IIheap)28 │ │ │ │ │ -b Fc(:)41 b Fi(DRAFT)121 b Fc(Ma)m(y)32 b(17,)f(2024)p │ │ │ │ │ -2698 100 V 1155 w Fk(3)111 399 y(2.)46 b Fj(void)h(IIheap_root)e(\()i │ │ │ │ │ +TeXDict begin 3 2 bop 91 100 1148 4 v 1330 100 a Fj(IIheap)28 │ │ │ │ │ +b Fc(:)41 b Fi(DRAFT)121 b Fc(June)29 b(20,)j(2025)p │ │ │ │ │ +2705 100 V 1148 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 May 17, 2024 │ │ │ │ │ │ + 2 IIheap : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 3 │ │ │ │ │ │ + IIheap : DRAFT June 20, 2025 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 2024.05.17:2218 │ │ │ │ │ +%DVIPSSource: TeX output 2025.06.20:0449 │ │ │ │ │ %%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 │ │ │ │ │ @@ -1608,22 +1608,21 @@ │ │ │ │ │ /UnderlinePosition -100 def │ │ │ │ │ /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 49 /one put │ │ │ │ │ dup 50 /two put │ │ │ │ │ -dup 52 /four put │ │ │ │ │ -dup 55 /seven put │ │ │ │ │ +dup 53 /five put │ │ │ │ │ dup 58 /colon put │ │ │ │ │ -dup 77 /M put │ │ │ │ │ -dup 97 /a put │ │ │ │ │ -dup 121 /y put │ │ │ │ │ +dup 74 /J put │ │ │ │ │ +dup 101 /e put │ │ │ │ │ +dup 110 /n put │ │ │ │ │ +dup 117 /u put │ │ │ │ │ readonly def │ │ │ │ │ currentdict end │ │ │ │ │ currentfile eexec │ │ │ │ │ D9D66F633B846AB284BCF8B0411B772DE5CE32340DC6F28AF40857E4451976E7 │ │ │ │ │ 5182433CF9F333A38BD841C0D4E68BF9E012EB32A8FFB76B5816306B5EDF7C99 │ │ │ │ │ 8B3A16D9B4BC056662E32C7CD0123DFAEB734C7532E64BBFBF5A60336E646716 │ │ │ │ │ EFB852C877F440D329172C71F1E5D59CE9473C26B8AEF7AD68EF0727B6EC2E0C │ │ │ │ │ @@ -1804,72 +1803,64 @@ │ │ │ │ │ 7CA1534C4D5B05FC33F83790ECFD7641DF3FB94289E2A1F6E7D29AB1228A867A │ │ │ │ │ 6E1EF0E9C6F899B491DC18401C2C0A05FFFED46A72C245F7529B8EA55A038082 │ │ │ │ │ 8512307217D2A233C37004085BA3AEE379269F9FA7D0ADB4B19A95CC2AFE686E │ │ │ │ │ 55D88E47257C1FE6F235FEA295910569FE6DD5995512562359CC821E85A6C7A5 │ │ │ │ │ 79B470A9E340A6985189FF8B6AF914A6B0ECF93F47903221F95DE894A8F05B05 │ │ │ │ │ B7D99CD533EC5F931B18E6B39BECF67FA2D6DD1AEC76772B068BE06335A94C05 │ │ │ │ │ 7A4DDEE77B66101DA855C17AC312600370B34E31F5EC3A01300A8EB60B4C9767 │ │ │ │ │ -1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004B9BA1CC │ │ │ │ │ -580D3C6BDA4DC1B80B4365F1C80512453FC5316EC2D928FB731C3D6403E3C18B │ │ │ │ │ -E8424D644DF5E9A2134229C5C91CA68DB8E85BA2BB40F538F585DA6FA4037718 │ │ │ │ │ -B8053EBBA1E765346BCD5BDAA6C38115D31611D8A87A2238C145F2DA2F92E4DF │ │ │ │ │ -3987BD9C4D2A3D460E8941A68B125BCD9EE4F9FD262C4C8A71F47A2C81975635 │ │ │ │ │ -F1B981C274C53FA2ACCDE4C9D0A7C62D6C1EFF91CFC6712CA6A9F333C9564FCB │ │ │ │ │ -2A70F0AD715A79B10A08AB069E2A3C93BC0AED19D0CA10134B8DDDE8AF548DB2 │ │ │ │ │ -3A4AAA9C29682CF135BB767DAA16169A127EB50A7EECEB6480CF56A7D0F8AC56 │ │ │ │ │ -4A5090B3D75A790372886AF568D94C8165975A05BFBFDF1FFBA45F70700BB9E0 │ │ │ │ │ -57F3249EF9E9C8AD9CBCF6E4FD592DC4CDD2CC7C0BC3130C1059096C657BE453 │ │ │ │ │ -A2CBACE93420210E27AF56CA229BD6D982FB68B3FDC6D44478B922C4231C47EE │ │ │ │ │ -E500232F6C11D92DEB955F66DF52B92B22E7352790CC2DCBAC53965D57AC2920 │ │ │ │ │ -68B7D520DE25047146EFEB06B9AD4E2A94243C7E5239F0BC2FC312B16051D52C │ │ │ │ │ -0B92C217B6B42997321AE4F8BB066754B7AA3F15069EF59224E8A442CE471AA7 │ │ │ │ │ -E8049A3DD9EDA09CCEE4998998661CF7DB35E952F6C65DAEB3013951C59F3E09 │ │ │ │ │ -157F313B0237876E1C0190F0473819570B8C0205AADF05D787CC00979CFB327A │ │ │ │ │ -289382B22DDA6F12804ED0ED5B179E36A995A2A59E1B66E75130DBE9109C813B │ │ │ │ │ -94403E0DEA8314A1E9DB474D7FA83C0BAFD08033E6A6215844C1D26BE15F1251 │ │ │ │ │ -A1605E8DF9A9C601ED37379530BC1C82BE5463C6C711C5652BFD6262485AA9CA │ │ │ │ │ -B8C4A117593001D08D980041E2A83C190DCE8E6CD3D334E5CC19FC05DB30F7F7 │ │ │ │ │ -24A305C4DBB31F0651392B99D44B4302333BDF7E326FD256DD75D309C6E73F85 │ │ │ │ │ -FA71B35FD1F9BEFF4C7A1076362EEB0A85492933B6006086A7B8C1928CF2D1EE │ │ │ │ │ -FD4344409257BB802C117E739960821CD3C88BFBA5669FF16F610AD638AF3677 │ │ │ │ │ -8674C985E6767253ED5769F71BEA5E9BB02A751F9E62EE2B18AC19D975FDEAE9 │ │ │ │ │ -8B8822367FF177A7E850766DE99ED3366D46464612926430012212A90F8E85F4 │ │ │ │ │ -4760B40D5B86B90819EE410382C23E86DCAF4F0FF5DFEB2C285965F4DCF2FB2B │ │ │ │ │ -457C0A0427A8D4ADA514E9DACD0F9367E1DA225DB21DA4DDAE33F2B529686D92 │ │ │ │ │ -AC085B345565F9DFFA012FD494DBB2E0B44A0787B2B72DC8D25399DAAE8864B7 │ │ │ │ │ -E84AA99DAFCEAF18F8B41882720316450F1B1CA48B418C9736E5CE4AFF996111 │ │ │ │ │ -5F7FE80958B6A3498508E9693CB134402D92E30D4C2939070D4647E13682290E │ │ │ │ │ -1D0820A3FCA7147157D09D1A40771F214EAE7DD743EA26839E535CA186C05CB8 │ │ │ │ │ -4874988AA1104D85AF0220FE7224344FF624E794BD2454E1C0AC971522FBECBA │ │ │ │ │ -B2497F25CD621B77EC5160973EF5ECC39C183DC051B0DFCB090194A2525BD96E │ │ │ │ │ -28593FDA80D8D259F039416D5F9AF0AD3C9A105B49DAF6E681921E369B7666C6 │ │ │ │ │ -2B73DB37447B00AE96317C2F1C44FB6E6EFD740BAB20FA03A8CE018EC8415582 │ │ │ │ │ -FB06E88A2971E3A480FB1EB4FE93CC7E5179721CAABEE88742B13CF0405F49F4 │ │ │ │ │ -945E587668C821D8C06D6847B6DF84CAFFCD4628670D551FC5F7236875BE1207 │ │ │ │ │ -634BA7F70A19B658FAE7D86F6D00ED28FBF29CC585DEE279325EEF8B0CCB6149 │ │ │ │ │ -E46E638C73D75148F18A636DBC2DD96ED34F68A5A09A3700B1EA34B2D142807C │ │ │ │ │ -F8709D81180783548EAE6F457BF968602076A1069163E3C15BBCEF659C6CF2E6 │ │ │ │ │ -0BB01BDC8E503802CC7969A5B8477E9788C5249B23B19669F5075E089738E49A │ │ │ │ │ -8671D7C1B1B47652F3D78BF2FF74EDB44BA5B092E8D5B85001E97F69D54AEEFC │ │ │ │ │ -88FC3CA1B0D5BAC39263B371005BCFA19AD197A31CC34D0BD55C2CA18C60C485 │ │ │ │ │ -5993F736EF1DD2C5D2B4D50B3D498861B4DF5E7AFF614BBCA4C2E6BECC0DCEF5 │ │ │ │ │ -95F0D686188014C530D8E37650CDCAE721B4AFB0F178BC744BDDDED45DAB7FEB │ │ │ │ │ -A10B975E26099E3DC61116D6BF554574F948895B88EEFE03DCC5351190836AD4 │ │ │ │ │ -EBC1AC55C6D099A8E7B0A372D290C481F44FA464B9C11A0BC991CB045E0AAAC4 │ │ │ │ │ -5C73CA43A4F17D1ADDD33D1B917FF95BFF411C8409F41553B1BC97DE47E3A1F4 │ │ │ │ │ -A5C1D1B7B1BF7E2507AC53956C141411F4F657E37981996DD7BB7ADB2CB6AE01 │ │ │ │ │ -73D0876B8F896F626D5022FE53BA34D5668BD698BE8D5CCAD083CBCEF440BE6A │ │ │ │ │ -8090EB1CDEE5F99C8988650BD4E539B357C31C597D8A9104A9D5967D4E906CAD │ │ │ │ │ -2A65575A884B1C5F6CC509E742FA9DDD66494F219178161AF72C50848E226A95 │ │ │ │ │ -A8C247FF9FF0BABD073021271B5C0692F9BE220071DAB09E5A026629371EE3C4 │ │ │ │ │ -A6E4FA94625D87A5B66EF077ED54C72B1052AEAA9637B30C76EF8EB04AD5F476 │ │ │ │ │ -D15F1C93C0BC6E0F67B366097BBED03FE82C040F9EF02866159B46854E11D44F │ │ │ │ │ -54AE6748A7E61B993A4EECD3B8BE3B5897A66BBCDFE24F65BC2AD5AB49048CF1 │ │ │ │ │ -647203823F84DF5CB483096F9D96AEE3A2855E479B72A14A67C633CE99C101CF │ │ │ │ │ -EFAE939BF9B02E710D │ │ │ │ │ +1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004ACD1870 │ │ │ │ │ +A5EA947858F5795870BFE1343AD803FB854BF8F5A4E794E8EC57BE41DB5B8734 │ │ │ │ │ +13E47950F29A81EA0C81EA798863883D7F41F78325CA190CBBFFE822AE494550 │ │ │ │ │ +4BE83703071FC9512D128927AF3F63CEF8F86ABE1E15D7B4DDD39576E7DFF45E │ │ │ │ │ +3CB4115AAB1830DE8647B915DB4BEBEB5235C281E098B899BAB951D8D5798F01 │ │ │ │ │ +7F7C47336D31438E5126738AFEAB29E9A7CBE06DE4DD604477B542D2620DFD58 │ │ │ │ │ +28FE34238572F23C5A8EB7ACEE1E154DA13FC1A5AA67A3BA8C5CDFB2B80312C9 │ │ │ │ │ +BC9FAE56D08DDFA9498E6EF0D0F6BD18B3923E0B670B0740528BC843610736CB │ │ │ │ │ +80228C105C2F72C3C22D610C3D8C268DEEA2AEEE3221E198E79FE2966487360C │ │ │ │ │ +84AE08AC326F48B21447652121B1EB68AF856055EEA65B6B625BF622CBFC2D1C │ │ │ │ │ +EF943CC4CAF2C715782C9EF9A9BA4689BFC6B6A82F8D55795BE8111E2C7DE520 │ │ │ │ │ +367362304B6A48186C842033E715A46265A352472F4F7313248EBCD26BEA97E7 │ │ │ │ │ +B814A61D4B7ADCB5C5F21AA34E0C1269E8426DBFB511DE6E26B960456C8F8520 │ │ │ │ │ +5F0DD382289A62AF0B935EDB5B2394538C5F0EE72962D2F98F3C38CD7C027B9F │ │ │ │ │ +E230E67E40FEFBDED06B3423C9DFD669E6B5BC913E0FF75786A64A6C11D4FE89 │ │ │ │ │ +1B918DC0E953C52CFD153063CD0D2A78B43F8712243845E6F2CBA1DB610F403D │ │ │ │ │ +A98D06D95FF44C7AC029092B666A8B0DCEA95B34F5ACC10E8611BADE6A24469C │ │ │ │ │ +0C01D95BFB445FA22CD38D033E4D24E006BB9D54EE41EF7AD5AC9C299721F61A │ │ │ │ │ +F01B6EDCDF428BD9195A13C5B1027358F8A203F828A1DD9622243B2D76C6F1BA │ │ │ │ │ +9F2D7E9D4879FC668ABC750CD25415DC6CCF2257C28F78D3F9BE499CC0FF2F80 │ │ │ │ │ +2C2CD1DEFABD6668FCA76E1D629A344333E33DA24B86D2E9F8F5EE1C29974640 │ │ │ │ │ +C3E78E999BAB313400041DADDDFDBFFCC419F129A84F4D412B79E8BE4511CA00 │ │ │ │ │ +F92A4F3CDD2E51345D3965C104F06B6503445DC20224CB7606A9D7D5F9EE45E6 │ │ │ │ │ +1B2963DA96AA2AB1BA5BE29656E666E4D0E122DE58EEA68E04ED76438DA03E65 │ │ │ │ │ +B80055A86B7B2A26BAE6BBB8835E17F9696E9B3CD34571BA75C76D4D2CCC48F1 │ │ │ │ │ +7534C1EF9127E374D65D05B8072E08D6C72A0B4A35EA0DD717743C66D105CCD8 │ │ │ │ │ +7355F13E9C38C1A4351624E689ED7909100942FA0474842EE44DEC3279E1A1CD │ │ │ │ │ +8064666EB845CA7C3E906B67C0BF96A28D514DB2E4A1E4AF287350B03762A2CF │ │ │ │ │ +13B18AC3F5D2F3B74A1D50267C03EFB74B888E1D24ABEEA4A885F4D0BF14C0D8 │ │ │ │ │ +289AC79D6D98E2A2C831672FB1F3457564CD161ADC3AF610D88201AB5B0C10CB │ │ │ │ │ +5ECCC2D5C4AF39C8CB3044BF9EC791BA45D29C2B51EA0483D19822C264CE6FA3 │ │ │ │ │ +5C97F2DF5A78CB93528E99B9ED7CB121C83130C129B849B52A36EBD88AF19DD3 │ │ │ │ │ +C5CABE831027388EF86BD5CBD90AAAC089775938A321C44D4DDA67A51312D8AB │ │ │ │ │ +C509DDBE7044A107AB2BE9C4C9556F85C529B174A7778B489BF28EC07A834542 │ │ │ │ │ +8B31F2925C21FB2096877711F998763D5A8495002B8E080AF8DBB1B3106EDDBA │ │ │ │ │ +35121D52E0846A7AF3ABEDF87BDE4FA665673A9B80CA538B98F873947AA17EF4 │ │ │ │ │ +9BB182917E9D79BC7EC681E93710D6A1D6B0E4A7FA9452FC1C431808174F3AB7 │ │ │ │ │ +F3914FBC86CB34E8583457243C3C7BE4BC166C7397689BC6FFB82EA2967E88EE │ │ │ │ │ +464F96EDA144DE2B64401B8E577ABCA2D826FE0B92E21FFAE3E81EBB6B6EB36E │ │ │ │ │ +9B1A8FE3884CA398C03135FD49D51724FC1268E9482E41FAEA2FC6C809006B8F │ │ │ │ │ +5D4F9E038450AD3A6041C16FD1C7E5FC80C0E033CE57E64863E014531D94DF1E │ │ │ │ │ +31D7D038AFCB60715AA73C1E96F113A24C5AF35BBEB61C4D079ED034ED83AA4A │ │ │ │ │ +E12448E618330463304788BCF40561CD63167B3BF144F408E2B89E60B8BA13EF │ │ │ │ │ +3B57D286FD23D4FA8BAEFF98DC1188B1982956CC1DCAEFC7D949B7B4E3BE8F8A │ │ │ │ │ +BFE2C9D938DD13EFEE7123576608D9396F260907DA98AE2D3DD5822306CBC8A6 │ │ │ │ │ +B083C697DDA3C62EE7879436A9FD8EE0034B105105B3F122F893EA2126EBE8A9 │ │ │ │ │ +5CBF2BD248DD9FBEF0040C25797BD13B69A8C9F0D4E4F935C61ED30487CCDB1A │ │ │ │ │ +0339006E78EE1755929D2412776EC7DB1F666DBDD28EA8AC7397F809C7F38A41 │ │ │ │ │ +5B3BF6C75F4F35C90141EB08377AF452CF840FEA938805F9D14E02DC29215B4E │ │ │ │ │ +F1EB │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ @@ -3742,17 +3733,17 @@ │ │ │ │ │ 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 /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 23[45 │ │ │ │ │ -19[83 18[25 2[45 2[45 1[45 45 45 3[25 44[{}10 90.9091 │ │ │ │ │ -/CMSL10 rf /Ff 152[45 45 102[{}2 90.9091 /CMSY10 rf │ │ │ │ │ +2[68 6[28 58[{}23 90.9091 /CMTI10 rf /Fe 138[51 6[51 │ │ │ │ │ +8[40 26[47 15[25 4[45 2[45 1[45 3[25 44[{}9 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 │ │ │ │ │ {/.notdef}repeat/dollar/.notdef/.notdef/quotesingle/.notdef/.notdef │ │ │ │ │ @@ -3878,17 +3869,17 @@ │ │ │ │ │ (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 1256 4 v │ │ │ │ │ -1438 w Fi(IV)29 b Fe(:)i Fd(DRAFT)f Fe(Ma)m(y)i(17,)f(2024)p │ │ │ │ │ -2645 100 V 0 399 a Fc(1.1)135 b(Data)46 b(Structure)0 │ │ │ │ │ +TeXDict begin 2 1 bop 0 100 a Fj(2)p 136 100 1249 4 v │ │ │ │ │ +1431 w Fi(IV)29 b Fe(:)i Fd(DRAFT)f Fe(June)g(20,)h(2025)p │ │ │ │ │ +2652 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 │ │ │ │ │ @@ -3946,17 +3937,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 1256 4 v 1437 100 a Fi(IV)30 │ │ │ │ │ -b Fe(:)g Fd(DRAFT)121 b Fe(Ma)m(y)32 b(17,)f(2024)p 2597 │ │ │ │ │ -100 V 1256 w Fj(3)0 399 y Fa(1.2.2)112 b(Instance)38 │ │ │ │ │ +TeXDict begin 3 2 bop 91 100 1249 4 v 1430 100 a Fi(IV)30 │ │ │ │ │ +b Fe(:)g Fd(DRAFT)122 b Fe(June)29 b(20,)i(2025)p 2604 │ │ │ │ │ +100 V 1249 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 │ │ │ │ │ @@ -4012,17 +4003,17 @@ │ │ │ │ │ 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 1256 4 v │ │ │ │ │ -1438 w Fi(IV)29 b Fe(:)i Fd(DRAFT)f Fe(Ma)m(y)i(17,)f(2024)p │ │ │ │ │ -2645 100 V 0 399 a Fa(1.2.3)112 b(Initializer)38 b(metho)s(ds)111 │ │ │ │ │ +TeXDict begin 4 3 bop 0 100 a Fj(4)p 136 100 1249 4 v │ │ │ │ │ +1431 w Fi(IV)29 b Fe(:)i Fd(DRAFT)f Fe(June)g(20,)h(2025)p │ │ │ │ │ +2652 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 │ │ │ │ │ @@ -4101,17 +4092,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 1256 4 v 1437 100 a Fi(IV)30 │ │ │ │ │ -b Fe(:)g Fd(DRAFT)121 b Fe(Ma)m(y)32 b(17,)f(2024)p 2597 │ │ │ │ │ -100 V 1256 w Fj(5)227 399 y(en)m(tries)e(and)e Fi(IV)p │ │ │ │ │ +TeXDict begin 5 4 bop 91 100 1249 4 v 1430 100 a Fi(IV)30 │ │ │ │ │ +b Fe(:)g Fd(DRAFT)122 b Fe(June)29 b(20,)i(2025)p 2604 │ │ │ │ │ +100 V 1249 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 │ │ │ │ │ @@ -4172,17 +4163,17 @@ │ │ │ │ │ (;)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 1256 4 v │ │ │ │ │ -1438 w Fi(IV)29 b Fe(:)i Fd(DRAFT)f Fe(Ma)m(y)i(17,)f(2024)p │ │ │ │ │ -2645 100 V 227 399 a Fj(of)f(the)g(v)m(ector.)42 b(The)29 │ │ │ │ │ +TeXDict begin 6 5 bop 0 100 a Fj(6)p 136 100 1249 4 v │ │ │ │ │ +1431 w Fi(IV)29 b Fe(:)i Fd(DRAFT)f Fe(June)g(20,)h(2025)p │ │ │ │ │ +2652 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(\)) │ │ │ │ │ @@ -4241,17 +4232,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 1256 4 v 1437 100 a Fi(IV)30 │ │ │ │ │ -b Fe(:)g Fd(DRAFT)121 b Fe(Ma)m(y)32 b(17,)f(2024)p 2597 │ │ │ │ │ -100 V 1256 w Fj(7)66 399 y(15.)46 b Fi(int)h(IV_findValue)e(\()i(IV)g │ │ │ │ │ +TeXDict begin 7 6 bop 91 100 1249 4 v 1430 100 a Fi(IV)30 │ │ │ │ │ +b Fe(:)g Fd(DRAFT)122 b Fe(June)29 b(20,)i(2025)p 2604 │ │ │ │ │ +100 V 1249 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 │ │ │ │ │ @@ -4322,17 +4313,17 @@ │ │ │ │ │ 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 1256 4 v │ │ │ │ │ -1438 w Fi(IV)29 b Fe(:)i Fd(DRAFT)f Fe(Ma)m(y)i(17,)f(2024)p │ │ │ │ │ -2645 100 V 111 399 a Fj(2.)46 b Fi(int)h(IV_readFromFormattedFile)41 │ │ │ │ │ +TeXDict begin 8 7 bop 0 100 a Fj(8)p 136 100 1249 4 v │ │ │ │ │ +1431 w Fi(IV)29 b Fe(:)i Fd(DRAFT)f Fe(June)g(20,)h(2025)p │ │ │ │ │ +2652 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 │ │ │ │ │ @@ -4410,17 +4401,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 1256 4 v 1437 100 a Fi(IV)30 │ │ │ │ │ -b Fe(:)g Fd(DRAFT)121 b Fe(Ma)m(y)32 b(17,)f(2024)p 2597 │ │ │ │ │ -100 V 1256 w Fj(9)66 399 y(10.)46 b Fi(int)h(IV_writeForMatlab)c(\()48 │ │ │ │ │ +TeXDict begin 9 8 bop 91 100 1249 4 v 1430 100 a Fi(IV)30 │ │ │ │ │ +b Fe(:)g Fd(DRAFT)122 b Fe(June)29 b(20,)i(2025)p 2604 │ │ │ │ │ +100 V 1249 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 May 17, 2024 │ │ │ │ │ │ + 2 IV : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 3 │ │ │ │ │ │ + IV : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 4 IV : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 5 │ │ │ │ │ │ + IV : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 6 IV : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 7 │ │ │ │ │ │ + IV : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 8 IV : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 9 │ │ │ │ │ │ + IV : DRAFT June 20, 2025 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 2024.05.17:2218 │ │ │ │ │ +%DVIPSSource: TeX output 2025.06.20:0449 │ │ │ │ │ %%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 │ │ │ │ │ @@ -1855,22 +1855,21 @@ │ │ │ │ │ /UnderlinePosition -100 def │ │ │ │ │ /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 49 /one put │ │ │ │ │ dup 50 /two put │ │ │ │ │ -dup 52 /four put │ │ │ │ │ -dup 55 /seven put │ │ │ │ │ +dup 53 /five put │ │ │ │ │ dup 58 /colon put │ │ │ │ │ -dup 77 /M put │ │ │ │ │ -dup 97 /a put │ │ │ │ │ -dup 121 /y put │ │ │ │ │ +dup 74 /J put │ │ │ │ │ +dup 101 /e put │ │ │ │ │ +dup 110 /n put │ │ │ │ │ +dup 117 /u put │ │ │ │ │ readonly def │ │ │ │ │ currentdict end │ │ │ │ │ currentfile eexec │ │ │ │ │ D9D66F633B846AB284BCF8B0411B772DE5CE32340DC6F28AF40857E4451976E7 │ │ │ │ │ 5182433CF9F333A38BD841C0D4E68BF9E012EB32A8FFB76B5816306B5EDF7C99 │ │ │ │ │ 8B3A16D9B4BC056662E32C7CD0123DFAEB734C7532E64BBFBF5A60336E646716 │ │ │ │ │ EFB852C877F440D329172C71F1E5D59CE9473C26B8AEF7AD68EF0727B6EC2E0C │ │ │ │ │ @@ -2051,72 +2050,64 @@ │ │ │ │ │ 7CA1534C4D5B05FC33F83790ECFD7641DF3FB94289E2A1F6E7D29AB1228A867A │ │ │ │ │ 6E1EF0E9C6F899B491DC18401C2C0A05FFFED46A72C245F7529B8EA55A038082 │ │ │ │ │ 8512307217D2A233C37004085BA3AEE379269F9FA7D0ADB4B19A95CC2AFE686E │ │ │ │ │ 55D88E47257C1FE6F235FEA295910569FE6DD5995512562359CC821E85A6C7A5 │ │ │ │ │ 79B470A9E340A6985189FF8B6AF914A6B0ECF93F47903221F95DE894A8F05B05 │ │ │ │ │ B7D99CD533EC5F931B18E6B39BECF67FA2D6DD1AEC76772B068BE06335A94C05 │ │ │ │ │ 7A4DDEE77B66101DA855C17AC312600370B34E31F5EC3A01300A8EB60B4C9767 │ │ │ │ │ -1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004B9BA1CC │ │ │ │ │ -580D3C6BDA4DC1B80B4365F1C80512453FC5316EC2D928FB731C3D6403E3C18B │ │ │ │ │ -E8424D644DF5E9A2134229C5C91CA68DB8E85BA2BB40F538F585DA6FA4037718 │ │ │ │ │ -B8053EBBA1E765346BCD5BDAA6C38115D31611D8A87A2238C145F2DA2F92E4DF │ │ │ │ │ -3987BD9C4D2A3D460E8941A68B125BCD9EE4F9FD262C4C8A71F47A2C81975635 │ │ │ │ │ -F1B981C274C53FA2ACCDE4C9D0A7C62D6C1EFF91CFC6712CA6A9F333C9564FCB │ │ │ │ │ -2A70F0AD715A79B10A08AB069E2A3C93BC0AED19D0CA10134B8DDDE8AF548DB2 │ │ │ │ │ -3A4AAA9C29682CF135BB767DAA16169A127EB50A7EECEB6480CF56A7D0F8AC56 │ │ │ │ │ -4A5090B3D75A790372886AF568D94C8165975A05BFBFDF1FFBA45F70700BB9E0 │ │ │ │ │ -57F3249EF9E9C8AD9CBCF6E4FD592DC4CDD2CC7C0BC3130C1059096C657BE453 │ │ │ │ │ -A2CBACE93420210E27AF56CA229BD6D982FB68B3FDC6D44478B922C4231C47EE │ │ │ │ │ -E500232F6C11D92DEB955F66DF52B92B22E7352790CC2DCBAC53965D57AC2920 │ │ │ │ │ -68B7D520DE25047146EFEB06B9AD4E2A94243C7E5239F0BC2FC312B16051D52C │ │ │ │ │ -0B92C217B6B42997321AE4F8BB066754B7AA3F15069EF59224E8A442CE471AA7 │ │ │ │ │ -E8049A3DD9EDA09CCEE4998998661CF7DB35E952F6C65DAEB3013951C59F3E09 │ │ │ │ │ -157F313B0237876E1C0190F0473819570B8C0205AADF05D787CC00979CFB327A │ │ │ │ │ -289382B22DDA6F12804ED0ED5B179E36A995A2A59E1B66E75130DBE9109C813B │ │ │ │ │ -94403E0DEA8314A1E9DB474D7FA83C0BAFD08033E6A6215844C1D26BE15F1251 │ │ │ │ │ -A1605E8DF9A9C601ED37379530BC1C82BE5463C6C711C5652BFD6262485AA9CA │ │ │ │ │ -B8C4A117593001D08D980041E2A83C190DCE8E6CD3D334E5CC19FC05DB30F7F7 │ │ │ │ │ -24A305C4DBB31F0651392B99D44B4302333BDF7E326FD256DD75D309C6E73F85 │ │ │ │ │ -FA71B35FD1F9BEFF4C7A1076362EEB0A85492933B6006086A7B8C1928CF2D1EE │ │ │ │ │ -FD4344409257BB802C117E739960821CD3C88BFBA5669FF16F610AD638AF3677 │ │ │ │ │ -8674C985E6767253ED5769F71BEA5E9BB02A751F9E62EE2B18AC19D975FDEAE9 │ │ │ │ │ -8B8822367FF177A7E850766DE99ED3366D46464612926430012212A90F8E85F4 │ │ │ │ │ -4760B40D5B86B90819EE410382C23E86DCAF4F0FF5DFEB2C285965F4DCF2FB2B │ │ │ │ │ -457C0A0427A8D4ADA514E9DACD0F9367E1DA225DB21DA4DDAE33F2B529686D92 │ │ │ │ │ -AC085B345565F9DFFA012FD494DBB2E0B44A0787B2B72DC8D25399DAAE8864B7 │ │ │ │ │ -E84AA99DAFCEAF18F8B41882720316450F1B1CA48B418C9736E5CE4AFF996111 │ │ │ │ │ -5F7FE80958B6A3498508E9693CB134402D92E30D4C2939070D4647E13682290E │ │ │ │ │ -1D0820A3FCA7147157D09D1A40771F214EAE7DD743EA26839E535CA186C05CB8 │ │ │ │ │ -4874988AA1104D85AF0220FE7224344FF624E794BD2454E1C0AC971522FBECBA │ │ │ │ │ -B2497F25CD621B77EC5160973EF5ECC39C183DC051B0DFCB090194A2525BD96E │ │ │ │ │ -28593FDA80D8D259F039416D5F9AF0AD3C9A105B49DAF6E681921E369B7666C6 │ │ │ │ │ -2B73DB37447B00AE96317C2F1C44FB6E6EFD740BAB20FA03A8CE018EC8415582 │ │ │ │ │ -FB06E88A2971E3A480FB1EB4FE93CC7E5179721CAABEE88742B13CF0405F49F4 │ │ │ │ │ -945E587668C821D8C06D6847B6DF84CAFFCD4628670D551FC5F7236875BE1207 │ │ │ │ │ -634BA7F70A19B658FAE7D86F6D00ED28FBF29CC585DEE279325EEF8B0CCB6149 │ │ │ │ │ -E46E638C73D75148F18A636DBC2DD96ED34F68A5A09A3700B1EA34B2D142807C │ │ │ │ │ -F8709D81180783548EAE6F457BF968602076A1069163E3C15BBCEF659C6CF2E6 │ │ │ │ │ -0BB01BDC8E503802CC7969A5B8477E9788C5249B23B19669F5075E089738E49A │ │ │ │ │ -8671D7C1B1B47652F3D78BF2FF74EDB44BA5B092E8D5B85001E97F69D54AEEFC │ │ │ │ │ -88FC3CA1B0D5BAC39263B371005BCFA19AD197A31CC34D0BD55C2CA18C60C485 │ │ │ │ │ -5993F736EF1DD2C5D2B4D50B3D498861B4DF5E7AFF614BBCA4C2E6BECC0DCEF5 │ │ │ │ │ -95F0D686188014C530D8E37650CDCAE721B4AFB0F178BC744BDDDED45DAB7FEB │ │ │ │ │ -A10B975E26099E3DC61116D6BF554574F948895B88EEFE03DCC5351190836AD4 │ │ │ │ │ -EBC1AC55C6D099A8E7B0A372D290C481F44FA464B9C11A0BC991CB045E0AAAC4 │ │ │ │ │ -5C73CA43A4F17D1ADDD33D1B917FF95BFF411C8409F41553B1BC97DE47E3A1F4 │ │ │ │ │ -A5C1D1B7B1BF7E2507AC53956C141411F4F657E37981996DD7BB7ADB2CB6AE01 │ │ │ │ │ -73D0876B8F896F626D5022FE53BA34D5668BD698BE8D5CCAD083CBCEF440BE6A │ │ │ │ │ -8090EB1CDEE5F99C8988650BD4E539B357C31C597D8A9104A9D5967D4E906CAD │ │ │ │ │ -2A65575A884B1C5F6CC509E742FA9DDD66494F219178161AF72C50848E226A95 │ │ │ │ │ -A8C247FF9FF0BABD073021271B5C0692F9BE220071DAB09E5A026629371EE3C4 │ │ │ │ │ -A6E4FA94625D87A5B66EF077ED54C72B1052AEAA9637B30C76EF8EB04AD5F476 │ │ │ │ │ -D15F1C93C0BC6E0F67B366097BBED03FE82C040F9EF02866159B46854E11D44F │ │ │ │ │ -54AE6748A7E61B993A4EECD3B8BE3B5897A66BBCDFE24F65BC2AD5AB49048CF1 │ │ │ │ │ -647203823F84DF5CB483096F9D96AEE3A2855E479B72A14A67C633CE99C101CF │ │ │ │ │ -EFAE939BF9B02E710D │ │ │ │ │ +1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004ACD1870 │ │ │ │ │ +A5EA947858F5795870BFE1343AD803FB854BF8F5A4E794E8EC57BE41DB5B8734 │ │ │ │ │ +13E47950F29A81EA0C81EA798863883D7F41F78325CA190CBBFFE822AE494550 │ │ │ │ │ +4BE83703071FC9512D128927AF3F63CEF8F86ABE1E15D7B4DDD39576E7DFF45E │ │ │ │ │ +3CB4115AAB1830DE8647B915DB4BEBEB5235C281E098B899BAB951D8D5798F01 │ │ │ │ │ +7F7C47336D31438E5126738AFEAB29E9A7CBE06DE4DD604477B542D2620DFD58 │ │ │ │ │ +28FE34238572F23C5A8EB7ACEE1E154DA13FC1A5AA67A3BA8C5CDFB2B80312C9 │ │ │ │ │ +BC9FAE56D08DDFA9498E6EF0D0F6BD18B3923E0B670B0740528BC843610736CB │ │ │ │ │ +80228C105C2F72C3C22D610C3D8C268DEEA2AEEE3221E198E79FE2966487360C │ │ │ │ │ +84AE08AC326F48B21447652121B1EB68AF856055EEA65B6B625BF622CBFC2D1C │ │ │ │ │ +EF943CC4CAF2C715782C9EF9A9BA4689BFC6B6A82F8D55795BE8111E2C7DE520 │ │ │ │ │ +367362304B6A48186C842033E715A46265A352472F4F7313248EBCD26BEA97E7 │ │ │ │ │ +B814A61D4B7ADCB5C5F21AA34E0C1269E8426DBFB511DE6E26B960456C8F8520 │ │ │ │ │ +5F0DD382289A62AF0B935EDB5B2394538C5F0EE72962D2F98F3C38CD7C027B9F │ │ │ │ │ +E230E67E40FEFBDED06B3423C9DFD669E6B5BC913E0FF75786A64A6C11D4FE89 │ │ │ │ │ +1B918DC0E953C52CFD153063CD0D2A78B43F8712243845E6F2CBA1DB610F403D │ │ │ │ │ +A98D06D95FF44C7AC029092B666A8B0DCEA95B34F5ACC10E8611BADE6A24469C │ │ │ │ │ +0C01D95BFB445FA22CD38D033E4D24E006BB9D54EE41EF7AD5AC9C299721F61A │ │ │ │ │ +F01B6EDCDF428BD9195A13C5B1027358F8A203F828A1DD9622243B2D76C6F1BA │ │ │ │ │ +9F2D7E9D4879FC668ABC750CD25415DC6CCF2257C28F78D3F9BE499CC0FF2F80 │ │ │ │ │ +2C2CD1DEFABD6668FCA76E1D629A344333E33DA24B86D2E9F8F5EE1C29974640 │ │ │ │ │ +C3E78E999BAB313400041DADDDFDBFFCC419F129A84F4D412B79E8BE4511CA00 │ │ │ │ │ +F92A4F3CDD2E51345D3965C104F06B6503445DC20224CB7606A9D7D5F9EE45E6 │ │ │ │ │ +1B2963DA96AA2AB1BA5BE29656E666E4D0E122DE58EEA68E04ED76438DA03E65 │ │ │ │ │ +B80055A86B7B2A26BAE6BBB8835E17F9696E9B3CD34571BA75C76D4D2CCC48F1 │ │ │ │ │ +7534C1EF9127E374D65D05B8072E08D6C72A0B4A35EA0DD717743C66D105CCD8 │ │ │ │ │ +7355F13E9C38C1A4351624E689ED7909100942FA0474842EE44DEC3279E1A1CD │ │ │ │ │ +8064666EB845CA7C3E906B67C0BF96A28D514DB2E4A1E4AF287350B03762A2CF │ │ │ │ │ +13B18AC3F5D2F3B74A1D50267C03EFB74B888E1D24ABEEA4A885F4D0BF14C0D8 │ │ │ │ │ +289AC79D6D98E2A2C831672FB1F3457564CD161ADC3AF610D88201AB5B0C10CB │ │ │ │ │ +5ECCC2D5C4AF39C8CB3044BF9EC791BA45D29C2B51EA0483D19822C264CE6FA3 │ │ │ │ │ +5C97F2DF5A78CB93528E99B9ED7CB121C83130C129B849B52A36EBD88AF19DD3 │ │ │ │ │ +C5CABE831027388EF86BD5CBD90AAAC089775938A321C44D4DDA67A51312D8AB │ │ │ │ │ +C509DDBE7044A107AB2BE9C4C9556F85C529B174A7778B489BF28EC07A834542 │ │ │ │ │ +8B31F2925C21FB2096877711F998763D5A8495002B8E080AF8DBB1B3106EDDBA │ │ │ │ │ +35121D52E0846A7AF3ABEDF87BDE4FA665673A9B80CA538B98F873947AA17EF4 │ │ │ │ │ +9BB182917E9D79BC7EC681E93710D6A1D6B0E4A7FA9452FC1C431808174F3AB7 │ │ │ │ │ +F3914FBC86CB34E8583457243C3C7BE4BC166C7397689BC6FFB82EA2967E88EE │ │ │ │ │ +464F96EDA144DE2B64401B8E577ABCA2D826FE0B92E21FFAE3E81EBB6B6EB36E │ │ │ │ │ +9B1A8FE3884CA398C03135FD49D51724FC1268E9482E41FAEA2FC6C809006B8F │ │ │ │ │ +5D4F9E038450AD3A6041C16FD1C7E5FC80C0E033CE57E64863E014531D94DF1E │ │ │ │ │ +31D7D038AFCB60715AA73C1E96F113A24C5AF35BBEB61C4D079ED034ED83AA4A │ │ │ │ │ +E12448E618330463304788BCF40561CD63167B3BF144F408E2B89E60B8BA13EF │ │ │ │ │ +3B57D286FD23D4FA8BAEFF98DC1188B1982956CC1DCAEFC7D949B7B4E3BE8F8A │ │ │ │ │ +BFE2C9D938DD13EFEE7123576608D9396F260907DA98AE2D3DD5822306CBC8A6 │ │ │ │ │ +B083C697DDA3C62EE7879436A9FD8EE0034B105105B3F122F893EA2126EBE8A9 │ │ │ │ │ +5CBF2BD248DD9FBEF0040C25797BD13B69A8C9F0D4E4F935C61ED30487CCDB1A │ │ │ │ │ +0339006E78EE1755929D2412776EC7DB1F666DBDD28EA8AC7397F809C7F38A41 │ │ │ │ │ +5B3BF6C75F4F35C90141EB08377AF452CF840FEA938805F9D14E02DC29215B4E │ │ │ │ │ +F1EB │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ @@ -3804,16 +3795,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 23[45 19[83 18[25 2[45 2[45 1[45 45 45 3[25 │ │ │ │ │ -44[{}10 90.9091 /CMSL10 rf │ │ │ │ │ +/Fe 138[51 6[51 8[40 26[47 15[25 4[45 2[45 1[45 3[25 │ │ │ │ │ +44[{}9 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 │ │ │ │ │ @@ -3929,17 +3920,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 1232 4 v │ │ │ │ │ -1414 w Fi(IVL)29 b Fe(:)i Fd(DRAFT)f Fe(Ma)m(y)h(17,)h(2024)p │ │ │ │ │ -2669 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 1225 4 v │ │ │ │ │ +1407 w Fi(IVL)29 b Fe(:)i Fd(DRAFT)f Fe(June)f(20,)j(2025)p │ │ │ │ │ +2676 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 │ │ │ │ │ @@ -4006,17 +3997,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 1232 4 v 1413 100 a Fi(IVL)30 │ │ │ │ │ -b Fe(:)g Fd(DRAFT)121 b Fe(Ma)m(y)32 b(17,)f(2024)p 2621 │ │ │ │ │ -100 V 1232 w Fj(3)111 399 y(3.)46 b Fi(void)h(IVL_clearData)d(\()k(IVL) │ │ │ │ │ +TeXDict begin 3 2 bop 91 100 1225 4 v 1406 100 a Fi(IVL)30 │ │ │ │ │ +b Fe(:)g Fd(DRAFT)121 b Fe(June)30 b(20,)h(2025)p 2628 │ │ │ │ │ +100 V 1225 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 │ │ │ │ │ @@ -4064,17 +4055,17 @@ │ │ │ │ │ (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 1232 4 v │ │ │ │ │ -1414 w Fi(IVL)29 b Fe(:)i Fd(DRAFT)f Fe(Ma)m(y)h(17,)h(2024)p │ │ │ │ │ -2669 100 V 0 399 a Fa(1.2.3)112 b(Initialization)39 b(and)f(resizing)g │ │ │ │ │ +TeXDict begin 4 3 bop 0 100 a Fj(4)p 136 100 1225 4 v │ │ │ │ │ +1407 w Fi(IVL)29 b Fe(:)i Fd(DRAFT)f Fe(June)f(20,)j(2025)p │ │ │ │ │ +2676 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 │ │ │ │ │ @@ -4153,17 +4144,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 1232 4 v 1413 100 a Fi(IVL)30 │ │ │ │ │ -b Fe(:)g Fd(DRAFT)121 b Fe(Ma)m(y)32 b(17,)f(2024)p 2621 │ │ │ │ │ -100 V 1232 w Fj(5)227 399 y(This)39 b(metho)s(d)f(is)h(used)g(to)g(c)m │ │ │ │ │ +TeXDict begin 5 4 bop 91 100 1225 4 v 1406 100 a Fi(IVL)30 │ │ │ │ │ +b Fe(:)g Fd(DRAFT)121 b Fe(June)30 b(20,)h(2025)p 2628 │ │ │ │ │ +100 V 1225 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 │ │ │ │ │ @@ -4206,17 +4197,17 @@ │ │ │ │ │ 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 1232 4 v │ │ │ │ │ -1414 w Fi(IVL)29 b Fe(:)i Fd(DRAFT)f Fe(Ma)m(y)h(17,)h(2024)p │ │ │ │ │ -2669 100 V 605 311 2918 4 v 605 2506 4 2196 v 663 414 │ │ │ │ │ +TeXDict begin 6 5 bop 0 100 a Fj(6)p 136 100 1225 4 v │ │ │ │ │ +1407 w Fi(IVL)29 b Fe(:)i Fd(DRAFT)f Fe(June)f(20,)j(2025)p │ │ │ │ │ +2676 100 V 605 311 2918 4 v 605 2506 4 2196 v 663 414 │ │ │ │ │ a Fj(if)f 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 │ │ │ │ │ @@ -4259,17 +4250,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 1232 4 v 1413 100 a Fi(IVL)30 │ │ │ │ │ -b Fe(:)g Fd(DRAFT)121 b Fe(Ma)m(y)32 b(17,)f(2024)p 2621 │ │ │ │ │ -100 V 1232 w Fj(7)111 399 y(3.)46 b Fi(int)h(IVL_sortUp)e(\()j(IVL)f │ │ │ │ │ +TeXDict begin 7 6 bop 91 100 1225 4 v 1406 100 a Fi(IVL)30 │ │ │ │ │ +b Fe(:)g Fd(DRAFT)121 b Fe(June)30 b(20,)h(2025)p 2628 │ │ │ │ │ +100 V 1225 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 │ │ │ │ │ @@ -4337,17 +4328,17 @@ │ │ │ │ │ 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 1232 4 v │ │ │ │ │ -1414 w Fi(IVL)29 b Fe(:)i Fd(DRAFT)f Fe(Ma)m(y)h(17,)h(2024)p │ │ │ │ │ -2669 100 V 0 399 a Fa(1.2.6)112 b(Miscellaneous)40 b(metho)s(ds)111 │ │ │ │ │ +TeXDict begin 8 7 bop 0 100 a Fj(8)p 136 100 1225 4 v │ │ │ │ │ +1407 w Fi(IVL)29 b Fe(:)i Fd(DRAFT)f Fe(June)f(20,)j(2025)p │ │ │ │ │ +2676 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 │ │ │ │ │ @@ -4411,17 +4402,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 1232 4 v 1413 100 a Fi(IVL)30 │ │ │ │ │ -b Fe(:)g Fd(DRAFT)121 b Fe(Ma)m(y)32 b(17,)f(2024)p 2621 │ │ │ │ │ -100 V 1232 w Fj(9)111 399 y(3.)46 b Fi(int)h(IVL_readFromBinaryFile)42 │ │ │ │ │ +TeXDict begin 9 8 bop 91 100 1225 4 v 1406 100 a Fi(IVL)30 │ │ │ │ │ +b Fe(:)g Fd(DRAFT)121 b Fe(June)30 b(20,)h(2025)p 2628 │ │ │ │ │ +100 V 1225 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 b(or)34 │ │ │ │ │ @@ -4487,17 +4478,17 @@ │ │ │ │ │ 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 1209 4 │ │ │ │ │ -v 1391 w Fi(IVL)30 b Fe(:)g Fd(DRAFT)h Fe(Ma)m(y)g(17,)h(2024)p │ │ │ │ │ -2691 100 V 337 399 a Ff(\210)45 b Fj(The)33 b Fi(msgFile)e │ │ │ │ │ +TeXDict begin 10 9 bop 0 100 a Fj(10)p 182 100 1202 4 │ │ │ │ │ +v 1384 w Fi(IVL)30 b Fe(:)g Fd(DRAFT)h Fe(June)e(20,)j(2025)p │ │ │ │ │ +2698 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 │ │ │ │ │ ├── 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 May 17, 2024 │ │ │ │ │ │ + 2 IVL : DRAFT June 20, 2025 │ │ │ │ │ │ • 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 May 17, 2024 3 │ │ │ │ │ │ + IVL : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 4 IVL : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 5 │ │ │ │ │ │ + IVL : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 6 IVL : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 7 │ │ │ │ │ │ + IVL : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 8 IVL : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 9 │ │ │ │ │ │ + IVL : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 10 IVL : DRAFT June 20, 2025 │ │ │ │ │ │ • 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 2024.05.17:2218 │ │ │ │ │ +%DVIPSSource: TeX output 2025.06.20:0449 │ │ │ │ │ %%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 │ │ │ │ │ @@ -1255,22 +1255,21 @@ │ │ │ │ │ /UnderlinePosition -100 def │ │ │ │ │ /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 49 /one put │ │ │ │ │ dup 50 /two put │ │ │ │ │ -dup 52 /four put │ │ │ │ │ -dup 55 /seven put │ │ │ │ │ +dup 53 /five put │ │ │ │ │ dup 58 /colon put │ │ │ │ │ -dup 77 /M put │ │ │ │ │ -dup 97 /a put │ │ │ │ │ -dup 121 /y put │ │ │ │ │ +dup 74 /J put │ │ │ │ │ +dup 101 /e put │ │ │ │ │ +dup 110 /n put │ │ │ │ │ +dup 117 /u put │ │ │ │ │ readonly def │ │ │ │ │ currentdict end │ │ │ │ │ currentfile eexec │ │ │ │ │ D9D66F633B846AB284BCF8B0411B772DE5CE32340DC6F28AF40857E4451976E7 │ │ │ │ │ 5182433CF9F333A38BD841C0D4E68BF9E012EB32A8FFB76B5816306B5EDF7C99 │ │ │ │ │ 8B3A16D9B4BC056662E32C7CD0123DFAEB734C7532E64BBFBF5A60336E646716 │ │ │ │ │ EFB852C877F440D329172C71F1E5D59CE9473C26B8AEF7AD68EF0727B6EC2E0C │ │ │ │ │ @@ -1451,72 +1450,64 @@ │ │ │ │ │ 7CA1534C4D5B05FC33F83790ECFD7641DF3FB94289E2A1F6E7D29AB1228A867A │ │ │ │ │ 6E1EF0E9C6F899B491DC18401C2C0A05FFFED46A72C245F7529B8EA55A038082 │ │ │ │ │ 8512307217D2A233C37004085BA3AEE379269F9FA7D0ADB4B19A95CC2AFE686E │ │ │ │ │ 55D88E47257C1FE6F235FEA295910569FE6DD5995512562359CC821E85A6C7A5 │ │ │ │ │ 79B470A9E340A6985189FF8B6AF914A6B0ECF93F47903221F95DE894A8F05B05 │ │ │ │ │ B7D99CD533EC5F931B18E6B39BECF67FA2D6DD1AEC76772B068BE06335A94C05 │ │ │ │ │ 7A4DDEE77B66101DA855C17AC312600370B34E31F5EC3A01300A8EB60B4C9767 │ │ │ │ │ -1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004B9BA1CC │ │ │ │ │ -580D3C6BDA4DC1B80B4365F1C80512453FC5316EC2D928FB731C3D6403E3C18B │ │ │ │ │ -E8424D644DF5E9A2134229C5C91CA68DB8E85BA2BB40F538F585DA6FA4037718 │ │ │ │ │ -B8053EBBA1E765346BCD5BDAA6C38115D31611D8A87A2238C145F2DA2F92E4DF │ │ │ │ │ -3987BD9C4D2A3D460E8941A68B125BCD9EE4F9FD262C4C8A71F47A2C81975635 │ │ │ │ │ -F1B981C274C53FA2ACCDE4C9D0A7C62D6C1EFF91CFC6712CA6A9F333C9564FCB │ │ │ │ │ -2A70F0AD715A79B10A08AB069E2A3C93BC0AED19D0CA10134B8DDDE8AF548DB2 │ │ │ │ │ -3A4AAA9C29682CF135BB767DAA16169A127EB50A7EECEB6480CF56A7D0F8AC56 │ │ │ │ │ -4A5090B3D75A790372886AF568D94C8165975A05BFBFDF1FFBA45F70700BB9E0 │ │ │ │ │ -57F3249EF9E9C8AD9CBCF6E4FD592DC4CDD2CC7C0BC3130C1059096C657BE453 │ │ │ │ │ -A2CBACE93420210E27AF56CA229BD6D982FB68B3FDC6D44478B922C4231C47EE │ │ │ │ │ -E500232F6C11D92DEB955F66DF52B92B22E7352790CC2DCBAC53965D57AC2920 │ │ │ │ │ -68B7D520DE25047146EFEB06B9AD4E2A94243C7E5239F0BC2FC312B16051D52C │ │ │ │ │ -0B92C217B6B42997321AE4F8BB066754B7AA3F15069EF59224E8A442CE471AA7 │ │ │ │ │ -E8049A3DD9EDA09CCEE4998998661CF7DB35E952F6C65DAEB3013951C59F3E09 │ │ │ │ │ -157F313B0237876E1C0190F0473819570B8C0205AADF05D787CC00979CFB327A │ │ │ │ │ -289382B22DDA6F12804ED0ED5B179E36A995A2A59E1B66E75130DBE9109C813B │ │ │ │ │ -94403E0DEA8314A1E9DB474D7FA83C0BAFD08033E6A6215844C1D26BE15F1251 │ │ │ │ │ -A1605E8DF9A9C601ED37379530BC1C82BE5463C6C711C5652BFD6262485AA9CA │ │ │ │ │ -B8C4A117593001D08D980041E2A83C190DCE8E6CD3D334E5CC19FC05DB30F7F7 │ │ │ │ │ -24A305C4DBB31F0651392B99D44B4302333BDF7E326FD256DD75D309C6E73F85 │ │ │ │ │ -FA71B35FD1F9BEFF4C7A1076362EEB0A85492933B6006086A7B8C1928CF2D1EE │ │ │ │ │ -FD4344409257BB802C117E739960821CD3C88BFBA5669FF16F610AD638AF3677 │ │ │ │ │ -8674C985E6767253ED5769F71BEA5E9BB02A751F9E62EE2B18AC19D975FDEAE9 │ │ │ │ │ -8B8822367FF177A7E850766DE99ED3366D46464612926430012212A90F8E85F4 │ │ │ │ │ -4760B40D5B86B90819EE410382C23E86DCAF4F0FF5DFEB2C285965F4DCF2FB2B │ │ │ │ │ -457C0A0427A8D4ADA514E9DACD0F9367E1DA225DB21DA4DDAE33F2B529686D92 │ │ │ │ │ -AC085B345565F9DFFA012FD494DBB2E0B44A0787B2B72DC8D25399DAAE8864B7 │ │ │ │ │ -E84AA99DAFCEAF18F8B41882720316450F1B1CA48B418C9736E5CE4AFF996111 │ │ │ │ │ -5F7FE80958B6A3498508E9693CB134402D92E30D4C2939070D4647E13682290E │ │ │ │ │ -1D0820A3FCA7147157D09D1A40771F214EAE7DD743EA26839E535CA186C05CB8 │ │ │ │ │ -4874988AA1104D85AF0220FE7224344FF624E794BD2454E1C0AC971522FBECBA │ │ │ │ │ -B2497F25CD621B77EC5160973EF5ECC39C183DC051B0DFCB090194A2525BD96E │ │ │ │ │ -28593FDA80D8D259F039416D5F9AF0AD3C9A105B49DAF6E681921E369B7666C6 │ │ │ │ │ -2B73DB37447B00AE96317C2F1C44FB6E6EFD740BAB20FA03A8CE018EC8415582 │ │ │ │ │ -FB06E88A2971E3A480FB1EB4FE93CC7E5179721CAABEE88742B13CF0405F49F4 │ │ │ │ │ -945E587668C821D8C06D6847B6DF84CAFFCD4628670D551FC5F7236875BE1207 │ │ │ │ │ -634BA7F70A19B658FAE7D86F6D00ED28FBF29CC585DEE279325EEF8B0CCB6149 │ │ │ │ │ -E46E638C73D75148F18A636DBC2DD96ED34F68A5A09A3700B1EA34B2D142807C │ │ │ │ │ -F8709D81180783548EAE6F457BF968602076A1069163E3C15BBCEF659C6CF2E6 │ │ │ │ │ -0BB01BDC8E503802CC7969A5B8477E9788C5249B23B19669F5075E089738E49A │ │ │ │ │ -8671D7C1B1B47652F3D78BF2FF74EDB44BA5B092E8D5B85001E97F69D54AEEFC │ │ │ │ │ -88FC3CA1B0D5BAC39263B371005BCFA19AD197A31CC34D0BD55C2CA18C60C485 │ │ │ │ │ -5993F736EF1DD2C5D2B4D50B3D498861B4DF5E7AFF614BBCA4C2E6BECC0DCEF5 │ │ │ │ │ -95F0D686188014C530D8E37650CDCAE721B4AFB0F178BC744BDDDED45DAB7FEB │ │ │ │ │ -A10B975E26099E3DC61116D6BF554574F948895B88EEFE03DCC5351190836AD4 │ │ │ │ │ -EBC1AC55C6D099A8E7B0A372D290C481F44FA464B9C11A0BC991CB045E0AAAC4 │ │ │ │ │ -5C73CA43A4F17D1ADDD33D1B917FF95BFF411C8409F41553B1BC97DE47E3A1F4 │ │ │ │ │ -A5C1D1B7B1BF7E2507AC53956C141411F4F657E37981996DD7BB7ADB2CB6AE01 │ │ │ │ │ -73D0876B8F896F626D5022FE53BA34D5668BD698BE8D5CCAD083CBCEF440BE6A │ │ │ │ │ -8090EB1CDEE5F99C8988650BD4E539B357C31C597D8A9104A9D5967D4E906CAD │ │ │ │ │ -2A65575A884B1C5F6CC509E742FA9DDD66494F219178161AF72C50848E226A95 │ │ │ │ │ -A8C247FF9FF0BABD073021271B5C0692F9BE220071DAB09E5A026629371EE3C4 │ │ │ │ │ -A6E4FA94625D87A5B66EF077ED54C72B1052AEAA9637B30C76EF8EB04AD5F476 │ │ │ │ │ -D15F1C93C0BC6E0F67B366097BBED03FE82C040F9EF02866159B46854E11D44F │ │ │ │ │ -54AE6748A7E61B993A4EECD3B8BE3B5897A66BBCDFE24F65BC2AD5AB49048CF1 │ │ │ │ │ -647203823F84DF5CB483096F9D96AEE3A2855E479B72A14A67C633CE99C101CF │ │ │ │ │ -EFAE939BF9B02E710D │ │ │ │ │ +1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004ACD1870 │ │ │ │ │ +A5EA947858F5795870BFE1343AD803FB854BF8F5A4E794E8EC57BE41DB5B8734 │ │ │ │ │ +13E47950F29A81EA0C81EA798863883D7F41F78325CA190CBBFFE822AE494550 │ │ │ │ │ +4BE83703071FC9512D128927AF3F63CEF8F86ABE1E15D7B4DDD39576E7DFF45E │ │ │ │ │ +3CB4115AAB1830DE8647B915DB4BEBEB5235C281E098B899BAB951D8D5798F01 │ │ │ │ │ +7F7C47336D31438E5126738AFEAB29E9A7CBE06DE4DD604477B542D2620DFD58 │ │ │ │ │ +28FE34238572F23C5A8EB7ACEE1E154DA13FC1A5AA67A3BA8C5CDFB2B80312C9 │ │ │ │ │ +BC9FAE56D08DDFA9498E6EF0D0F6BD18B3923E0B670B0740528BC843610736CB │ │ │ │ │ +80228C105C2F72C3C22D610C3D8C268DEEA2AEEE3221E198E79FE2966487360C │ │ │ │ │ +84AE08AC326F48B21447652121B1EB68AF856055EEA65B6B625BF622CBFC2D1C │ │ │ │ │ +EF943CC4CAF2C715782C9EF9A9BA4689BFC6B6A82F8D55795BE8111E2C7DE520 │ │ │ │ │ +367362304B6A48186C842033E715A46265A352472F4F7313248EBCD26BEA97E7 │ │ │ │ │ +B814A61D4B7ADCB5C5F21AA34E0C1269E8426DBFB511DE6E26B960456C8F8520 │ │ │ │ │ +5F0DD382289A62AF0B935EDB5B2394538C5F0EE72962D2F98F3C38CD7C027B9F │ │ │ │ │ +E230E67E40FEFBDED06B3423C9DFD669E6B5BC913E0FF75786A64A6C11D4FE89 │ │ │ │ │ +1B918DC0E953C52CFD153063CD0D2A78B43F8712243845E6F2CBA1DB610F403D │ │ │ │ │ +A98D06D95FF44C7AC029092B666A8B0DCEA95B34F5ACC10E8611BADE6A24469C │ │ │ │ │ +0C01D95BFB445FA22CD38D033E4D24E006BB9D54EE41EF7AD5AC9C299721F61A │ │ │ │ │ +F01B6EDCDF428BD9195A13C5B1027358F8A203F828A1DD9622243B2D76C6F1BA │ │ │ │ │ +9F2D7E9D4879FC668ABC750CD25415DC6CCF2257C28F78D3F9BE499CC0FF2F80 │ │ │ │ │ +2C2CD1DEFABD6668FCA76E1D629A344333E33DA24B86D2E9F8F5EE1C29974640 │ │ │ │ │ +C3E78E999BAB313400041DADDDFDBFFCC419F129A84F4D412B79E8BE4511CA00 │ │ │ │ │ +F92A4F3CDD2E51345D3965C104F06B6503445DC20224CB7606A9D7D5F9EE45E6 │ │ │ │ │ +1B2963DA96AA2AB1BA5BE29656E666E4D0E122DE58EEA68E04ED76438DA03E65 │ │ │ │ │ +B80055A86B7B2A26BAE6BBB8835E17F9696E9B3CD34571BA75C76D4D2CCC48F1 │ │ │ │ │ +7534C1EF9127E374D65D05B8072E08D6C72A0B4A35EA0DD717743C66D105CCD8 │ │ │ │ │ +7355F13E9C38C1A4351624E689ED7909100942FA0474842EE44DEC3279E1A1CD │ │ │ │ │ +8064666EB845CA7C3E906B67C0BF96A28D514DB2E4A1E4AF287350B03762A2CF │ │ │ │ │ +13B18AC3F5D2F3B74A1D50267C03EFB74B888E1D24ABEEA4A885F4D0BF14C0D8 │ │ │ │ │ +289AC79D6D98E2A2C831672FB1F3457564CD161ADC3AF610D88201AB5B0C10CB │ │ │ │ │ +5ECCC2D5C4AF39C8CB3044BF9EC791BA45D29C2B51EA0483D19822C264CE6FA3 │ │ │ │ │ +5C97F2DF5A78CB93528E99B9ED7CB121C83130C129B849B52A36EBD88AF19DD3 │ │ │ │ │ +C5CABE831027388EF86BD5CBD90AAAC089775938A321C44D4DDA67A51312D8AB │ │ │ │ │ +C509DDBE7044A107AB2BE9C4C9556F85C529B174A7778B489BF28EC07A834542 │ │ │ │ │ +8B31F2925C21FB2096877711F998763D5A8495002B8E080AF8DBB1B3106EDDBA │ │ │ │ │ +35121D52E0846A7AF3ABEDF87BDE4FA665673A9B80CA538B98F873947AA17EF4 │ │ │ │ │ +9BB182917E9D79BC7EC681E93710D6A1D6B0E4A7FA9452FC1C431808174F3AB7 │ │ │ │ │ +F3914FBC86CB34E8583457243C3C7BE4BC166C7397689BC6FFB82EA2967E88EE │ │ │ │ │ +464F96EDA144DE2B64401B8E577ABCA2D826FE0B92E21FFAE3E81EBB6B6EB36E │ │ │ │ │ +9B1A8FE3884CA398C03135FD49D51724FC1268E9482E41FAEA2FC6C809006B8F │ │ │ │ │ +5D4F9E038450AD3A6041C16FD1C7E5FC80C0E033CE57E64863E014531D94DF1E │ │ │ │ │ +31D7D038AFCB60715AA73C1E96F113A24C5AF35BBEB61C4D079ED034ED83AA4A │ │ │ │ │ +E12448E618330463304788BCF40561CD63167B3BF144F408E2B89E60B8BA13EF │ │ │ │ │ +3B57D286FD23D4FA8BAEFF98DC1188B1982956CC1DCAEFC7D949B7B4E3BE8F8A │ │ │ │ │ +BFE2C9D938DD13EFEE7123576608D9396F260907DA98AE2D3DD5822306CBC8A6 │ │ │ │ │ +B083C697DDA3C62EE7879436A9FD8EE0034B105105B3F122F893EA2126EBE8A9 │ │ │ │ │ +5CBF2BD248DD9FBEF0040C25797BD13B69A8C9F0D4E4F935C61ED30487CCDB1A │ │ │ │ │ +0339006E78EE1755929D2412776EC7DB1F666DBDD28EA8AC7397F809C7F38A41 │ │ │ │ │ +5B3BF6C75F4F35C90141EB08377AF452CF840FEA938805F9D14E02DC29215B4E │ │ │ │ │ +F1EB │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ @@ -3196,17 +3187,17 @@ │ │ │ │ │ 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 23[45 19[83 18[25 2[45 2[45 1[45 45 45 │ │ │ │ │ -3[25 44[{}10 90.9091 /CMSL10 rf /Fd 142[62 11[62 62 26[62 │ │ │ │ │ -73[{}4 119.552 /CMTT12 rf │ │ │ │ │ +rf /Fc 138[51 6[51 8[40 26[47 15[25 4[45 2[45 1[45 3[25 │ │ │ │ │ +44[{}9 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 │ │ │ │ │ {/.notdef}repeat/dollar/.notdef/.notdef/quotesingle/.notdef/.notdef │ │ │ │ │ @@ -3305,17 +3296,17 @@ │ │ │ │ │ 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 1203 4 v │ │ │ │ │ -1385 w Fh(Ideq)29 b Fc(:)41 b Fg(DRAFT)30 b Fc(Ma)m(y)h(17,)h(2024)p │ │ │ │ │ -2698 100 V 0 399 a Fb(1.2.1)112 b(Basic)38 b(metho)s(ds)0 │ │ │ │ │ +TeXDict begin 2 1 bop 0 100 a Fi(2)p 136 100 1196 4 v │ │ │ │ │ +1378 w Fh(Ideq)29 b Fc(:)41 b Fg(DRAFT)30 b Fc(June)f(20,)j(2025)p │ │ │ │ │ +2704 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) │ │ │ │ │ @@ -3370,17 +3361,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 1203 4 v 1384 100 a Fh(Ideq)29 │ │ │ │ │ -b Fc(:)41 b Fg(DRAFT)121 b Fc(Ma)m(y)32 b(17,)f(2024)p │ │ │ │ │ -2650 100 V 1203 w Fi(3)0 399 y Fb(1.2.3)112 b(Utilit)m(y)38 │ │ │ │ │ +TeXDict begin 3 2 bop 91 100 1196 4 v 1377 100 a Fh(Ideq)30 │ │ │ │ │ +b Fc(:)40 b Fg(DRAFT)121 b Fc(June)30 b(20,)h(2025)p │ │ │ │ │ +2657 100 V 1196 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 │ │ │ │ │ @@ -3449,17 +3440,17 @@ │ │ │ │ │ 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 1203 4 v │ │ │ │ │ -1385 w Fh(Ideq)29 b Fc(:)41 b Fg(DRAFT)30 b Fc(Ma)m(y)h(17,)h(2024)p │ │ │ │ │ -2698 100 V 0 399 a Fb(1.2.4)112 b(IO)38 b(metho)s(ds)111 │ │ │ │ │ +TeXDict begin 4 3 bop 0 100 a Fi(4)p 136 100 1196 4 v │ │ │ │ │ +1378 w Fh(Ideq)29 b Fc(:)41 b Fg(DRAFT)30 b Fc(June)f(20,)j(2025)p │ │ │ │ │ +2704 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 │ │ │ │ │ ├── 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 May 17, 2024 │ │ │ │ │ │ + 2 Ideq : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 3 │ │ │ │ │ │ + Ideq : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 4 Ideq : DRAFT June 20, 2025 │ │ │ │ │ │ 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 2024.05.17:2218 │ │ │ │ │ +%DVIPSSource: TeX output 2025.06.20:0449 │ │ │ │ │ %%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 │ │ │ │ │ @@ -2762,22 +2762,21 @@ │ │ │ │ │ /UnderlinePosition -100 def │ │ │ │ │ /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 49 /one put │ │ │ │ │ dup 50 /two put │ │ │ │ │ -dup 52 /four put │ │ │ │ │ -dup 55 /seven put │ │ │ │ │ +dup 53 /five put │ │ │ │ │ dup 58 /colon put │ │ │ │ │ -dup 77 /M put │ │ │ │ │ -dup 97 /a put │ │ │ │ │ -dup 121 /y put │ │ │ │ │ +dup 74 /J put │ │ │ │ │ +dup 101 /e put │ │ │ │ │ +dup 110 /n put │ │ │ │ │ +dup 117 /u put │ │ │ │ │ readonly def │ │ │ │ │ currentdict end │ │ │ │ │ currentfile eexec │ │ │ │ │ D9D66F633B846AB284BCF8B0411B772DE5CE32340DC6F28AF40857E4451976E7 │ │ │ │ │ 5182433CF9F333A38BD841C0D4E68BF9E012EB32A8FFB76B5816306B5EDF7C99 │ │ │ │ │ 8B3A16D9B4BC056662E32C7CD0123DFAEB734C7532E64BBFBF5A60336E646716 │ │ │ │ │ EFB852C877F440D329172C71F1E5D59CE9473C26B8AEF7AD68EF0727B6EC2E0C │ │ │ │ │ @@ -2958,72 +2957,64 @@ │ │ │ │ │ 7CA1534C4D5B05FC33F83790ECFD7641DF3FB94289E2A1F6E7D29AB1228A867A │ │ │ │ │ 6E1EF0E9C6F899B491DC18401C2C0A05FFFED46A72C245F7529B8EA55A038082 │ │ │ │ │ 8512307217D2A233C37004085BA3AEE379269F9FA7D0ADB4B19A95CC2AFE686E │ │ │ │ │ 55D88E47257C1FE6F235FEA295910569FE6DD5995512562359CC821E85A6C7A5 │ │ │ │ │ 79B470A9E340A6985189FF8B6AF914A6B0ECF93F47903221F95DE894A8F05B05 │ │ │ │ │ B7D99CD533EC5F931B18E6B39BECF67FA2D6DD1AEC76772B068BE06335A94C05 │ │ │ │ │ 7A4DDEE77B66101DA855C17AC312600370B34E31F5EC3A01300A8EB60B4C9767 │ │ │ │ │ -1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004B9BA1CC │ │ │ │ │ -580D3C6BDA4DC1B80B4365F1C80512453FC5316EC2D928FB731C3D6403E3C18B │ │ │ │ │ -E8424D644DF5E9A2134229C5C91CA68DB8E85BA2BB40F538F585DA6FA4037718 │ │ │ │ │ -B8053EBBA1E765346BCD5BDAA6C38115D31611D8A87A2238C145F2DA2F92E4DF │ │ │ │ │ -3987BD9C4D2A3D460E8941A68B125BCD9EE4F9FD262C4C8A71F47A2C81975635 │ │ │ │ │ -F1B981C274C53FA2ACCDE4C9D0A7C62D6C1EFF91CFC6712CA6A9F333C9564FCB │ │ │ │ │ -2A70F0AD715A79B10A08AB069E2A3C93BC0AED19D0CA10134B8DDDE8AF548DB2 │ │ │ │ │ -3A4AAA9C29682CF135BB767DAA16169A127EB50A7EECEB6480CF56A7D0F8AC56 │ │ │ │ │ -4A5090B3D75A790372886AF568D94C8165975A05BFBFDF1FFBA45F70700BB9E0 │ │ │ │ │ -57F3249EF9E9C8AD9CBCF6E4FD592DC4CDD2CC7C0BC3130C1059096C657BE453 │ │ │ │ │ -A2CBACE93420210E27AF56CA229BD6D982FB68B3FDC6D44478B922C4231C47EE │ │ │ │ │ -E500232F6C11D92DEB955F66DF52B92B22E7352790CC2DCBAC53965D57AC2920 │ │ │ │ │ -68B7D520DE25047146EFEB06B9AD4E2A94243C7E5239F0BC2FC312B16051D52C │ │ │ │ │ -0B92C217B6B42997321AE4F8BB066754B7AA3F15069EF59224E8A442CE471AA7 │ │ │ │ │ -E8049A3DD9EDA09CCEE4998998661CF7DB35E952F6C65DAEB3013951C59F3E09 │ │ │ │ │ -157F313B0237876E1C0190F0473819570B8C0205AADF05D787CC00979CFB327A │ │ │ │ │ -289382B22DDA6F12804ED0ED5B179E36A995A2A59E1B66E75130DBE9109C813B │ │ │ │ │ -94403E0DEA8314A1E9DB474D7FA83C0BAFD08033E6A6215844C1D26BE15F1251 │ │ │ │ │ -A1605E8DF9A9C601ED37379530BC1C82BE5463C6C711C5652BFD6262485AA9CA │ │ │ │ │ -B8C4A117593001D08D980041E2A83C190DCE8E6CD3D334E5CC19FC05DB30F7F7 │ │ │ │ │ -24A305C4DBB31F0651392B99D44B4302333BDF7E326FD256DD75D309C6E73F85 │ │ │ │ │ -FA71B35FD1F9BEFF4C7A1076362EEB0A85492933B6006086A7B8C1928CF2D1EE │ │ │ │ │ -FD4344409257BB802C117E739960821CD3C88BFBA5669FF16F610AD638AF3677 │ │ │ │ │ -8674C985E6767253ED5769F71BEA5E9BB02A751F9E62EE2B18AC19D975FDEAE9 │ │ │ │ │ -8B8822367FF177A7E850766DE99ED3366D46464612926430012212A90F8E85F4 │ │ │ │ │ -4760B40D5B86B90819EE410382C23E86DCAF4F0FF5DFEB2C285965F4DCF2FB2B │ │ │ │ │ -457C0A0427A8D4ADA514E9DACD0F9367E1DA225DB21DA4DDAE33F2B529686D92 │ │ │ │ │ -AC085B345565F9DFFA012FD494DBB2E0B44A0787B2B72DC8D25399DAAE8864B7 │ │ │ │ │ -E84AA99DAFCEAF18F8B41882720316450F1B1CA48B418C9736E5CE4AFF996111 │ │ │ │ │ -5F7FE80958B6A3498508E9693CB134402D92E30D4C2939070D4647E13682290E │ │ │ │ │ -1D0820A3FCA7147157D09D1A40771F214EAE7DD743EA26839E535CA186C05CB8 │ │ │ │ │ -4874988AA1104D85AF0220FE7224344FF624E794BD2454E1C0AC971522FBECBA │ │ │ │ │ -B2497F25CD621B77EC5160973EF5ECC39C183DC051B0DFCB090194A2525BD96E │ │ │ │ │ -28593FDA80D8D259F039416D5F9AF0AD3C9A105B49DAF6E681921E369B7666C6 │ │ │ │ │ -2B73DB37447B00AE96317C2F1C44FB6E6EFD740BAB20FA03A8CE018EC8415582 │ │ │ │ │ -FB06E88A2971E3A480FB1EB4FE93CC7E5179721CAABEE88742B13CF0405F49F4 │ │ │ │ │ -945E587668C821D8C06D6847B6DF84CAFFCD4628670D551FC5F7236875BE1207 │ │ │ │ │ -634BA7F70A19B658FAE7D86F6D00ED28FBF29CC585DEE279325EEF8B0CCB6149 │ │ │ │ │ -E46E638C73D75148F18A636DBC2DD96ED34F68A5A09A3700B1EA34B2D142807C │ │ │ │ │ -F8709D81180783548EAE6F457BF968602076A1069163E3C15BBCEF659C6CF2E6 │ │ │ │ │ -0BB01BDC8E503802CC7969A5B8477E9788C5249B23B19669F5075E089738E49A │ │ │ │ │ -8671D7C1B1B47652F3D78BF2FF74EDB44BA5B092E8D5B85001E97F69D54AEEFC │ │ │ │ │ -88FC3CA1B0D5BAC39263B371005BCFA19AD197A31CC34D0BD55C2CA18C60C485 │ │ │ │ │ -5993F736EF1DD2C5D2B4D50B3D498861B4DF5E7AFF614BBCA4C2E6BECC0DCEF5 │ │ │ │ │ -95F0D686188014C530D8E37650CDCAE721B4AFB0F178BC744BDDDED45DAB7FEB │ │ │ │ │ -A10B975E26099E3DC61116D6BF554574F948895B88EEFE03DCC5351190836AD4 │ │ │ │ │ -EBC1AC55C6D099A8E7B0A372D290C481F44FA464B9C11A0BC991CB045E0AAAC4 │ │ │ │ │ -5C73CA43A4F17D1ADDD33D1B917FF95BFF411C8409F41553B1BC97DE47E3A1F4 │ │ │ │ │ -A5C1D1B7B1BF7E2507AC53956C141411F4F657E37981996DD7BB7ADB2CB6AE01 │ │ │ │ │ -73D0876B8F896F626D5022FE53BA34D5668BD698BE8D5CCAD083CBCEF440BE6A │ │ │ │ │ -8090EB1CDEE5F99C8988650BD4E539B357C31C597D8A9104A9D5967D4E906CAD │ │ │ │ │ -2A65575A884B1C5F6CC509E742FA9DDD66494F219178161AF72C50848E226A95 │ │ │ │ │ -A8C247FF9FF0BABD073021271B5C0692F9BE220071DAB09E5A026629371EE3C4 │ │ │ │ │ -A6E4FA94625D87A5B66EF077ED54C72B1052AEAA9637B30C76EF8EB04AD5F476 │ │ │ │ │ -D15F1C93C0BC6E0F67B366097BBED03FE82C040F9EF02866159B46854E11D44F │ │ │ │ │ -54AE6748A7E61B993A4EECD3B8BE3B5897A66BBCDFE24F65BC2AD5AB49048CF1 │ │ │ │ │ -647203823F84DF5CB483096F9D96AEE3A2855E479B72A14A67C633CE99C101CF │ │ │ │ │ -EFAE939BF9B02E710D │ │ │ │ │ +1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004ACD1870 │ │ │ │ │ +A5EA947858F5795870BFE1343AD803FB854BF8F5A4E794E8EC57BE41DB5B8734 │ │ │ │ │ +13E47950F29A81EA0C81EA798863883D7F41F78325CA190CBBFFE822AE494550 │ │ │ │ │ +4BE83703071FC9512D128927AF3F63CEF8F86ABE1E15D7B4DDD39576E7DFF45E │ │ │ │ │ +3CB4115AAB1830DE8647B915DB4BEBEB5235C281E098B899BAB951D8D5798F01 │ │ │ │ │ +7F7C47336D31438E5126738AFEAB29E9A7CBE06DE4DD604477B542D2620DFD58 │ │ │ │ │ +28FE34238572F23C5A8EB7ACEE1E154DA13FC1A5AA67A3BA8C5CDFB2B80312C9 │ │ │ │ │ +BC9FAE56D08DDFA9498E6EF0D0F6BD18B3923E0B670B0740528BC843610736CB │ │ │ │ │ +80228C105C2F72C3C22D610C3D8C268DEEA2AEEE3221E198E79FE2966487360C │ │ │ │ │ +84AE08AC326F48B21447652121B1EB68AF856055EEA65B6B625BF622CBFC2D1C │ │ │ │ │ +EF943CC4CAF2C715782C9EF9A9BA4689BFC6B6A82F8D55795BE8111E2C7DE520 │ │ │ │ │ +367362304B6A48186C842033E715A46265A352472F4F7313248EBCD26BEA97E7 │ │ │ │ │ +B814A61D4B7ADCB5C5F21AA34E0C1269E8426DBFB511DE6E26B960456C8F8520 │ │ │ │ │ +5F0DD382289A62AF0B935EDB5B2394538C5F0EE72962D2F98F3C38CD7C027B9F │ │ │ │ │ +E230E67E40FEFBDED06B3423C9DFD669E6B5BC913E0FF75786A64A6C11D4FE89 │ │ │ │ │ +1B918DC0E953C52CFD153063CD0D2A78B43F8712243845E6F2CBA1DB610F403D │ │ │ │ │ +A98D06D95FF44C7AC029092B666A8B0DCEA95B34F5ACC10E8611BADE6A24469C │ │ │ │ │ +0C01D95BFB445FA22CD38D033E4D24E006BB9D54EE41EF7AD5AC9C299721F61A │ │ │ │ │ +F01B6EDCDF428BD9195A13C5B1027358F8A203F828A1DD9622243B2D76C6F1BA │ │ │ │ │ +9F2D7E9D4879FC668ABC750CD25415DC6CCF2257C28F78D3F9BE499CC0FF2F80 │ │ │ │ │ +2C2CD1DEFABD6668FCA76E1D629A344333E33DA24B86D2E9F8F5EE1C29974640 │ │ │ │ │ +C3E78E999BAB313400041DADDDFDBFFCC419F129A84F4D412B79E8BE4511CA00 │ │ │ │ │ +F92A4F3CDD2E51345D3965C104F06B6503445DC20224CB7606A9D7D5F9EE45E6 │ │ │ │ │ +1B2963DA96AA2AB1BA5BE29656E666E4D0E122DE58EEA68E04ED76438DA03E65 │ │ │ │ │ +B80055A86B7B2A26BAE6BBB8835E17F9696E9B3CD34571BA75C76D4D2CCC48F1 │ │ │ │ │ +7534C1EF9127E374D65D05B8072E08D6C72A0B4A35EA0DD717743C66D105CCD8 │ │ │ │ │ +7355F13E9C38C1A4351624E689ED7909100942FA0474842EE44DEC3279E1A1CD │ │ │ │ │ +8064666EB845CA7C3E906B67C0BF96A28D514DB2E4A1E4AF287350B03762A2CF │ │ │ │ │ +13B18AC3F5D2F3B74A1D50267C03EFB74B888E1D24ABEEA4A885F4D0BF14C0D8 │ │ │ │ │ +289AC79D6D98E2A2C831672FB1F3457564CD161ADC3AF610D88201AB5B0C10CB │ │ │ │ │ +5ECCC2D5C4AF39C8CB3044BF9EC791BA45D29C2B51EA0483D19822C264CE6FA3 │ │ │ │ │ +5C97F2DF5A78CB93528E99B9ED7CB121C83130C129B849B52A36EBD88AF19DD3 │ │ │ │ │ +C5CABE831027388EF86BD5CBD90AAAC089775938A321C44D4DDA67A51312D8AB │ │ │ │ │ +C509DDBE7044A107AB2BE9C4C9556F85C529B174A7778B489BF28EC07A834542 │ │ │ │ │ +8B31F2925C21FB2096877711F998763D5A8495002B8E080AF8DBB1B3106EDDBA │ │ │ │ │ +35121D52E0846A7AF3ABEDF87BDE4FA665673A9B80CA538B98F873947AA17EF4 │ │ │ │ │ +9BB182917E9D79BC7EC681E93710D6A1D6B0E4A7FA9452FC1C431808174F3AB7 │ │ │ │ │ +F3914FBC86CB34E8583457243C3C7BE4BC166C7397689BC6FFB82EA2967E88EE │ │ │ │ │ +464F96EDA144DE2B64401B8E577ABCA2D826FE0B92E21FFAE3E81EBB6B6EB36E │ │ │ │ │ +9B1A8FE3884CA398C03135FD49D51724FC1268E9482E41FAEA2FC6C809006B8F │ │ │ │ │ +5D4F9E038450AD3A6041C16FD1C7E5FC80C0E033CE57E64863E014531D94DF1E │ │ │ │ │ +31D7D038AFCB60715AA73C1E96F113A24C5AF35BBEB61C4D079ED034ED83AA4A │ │ │ │ │ +E12448E618330463304788BCF40561CD63167B3BF144F408E2B89E60B8BA13EF │ │ │ │ │ +3B57D286FD23D4FA8BAEFF98DC1188B1982956CC1DCAEFC7D949B7B4E3BE8F8A │ │ │ │ │ +BFE2C9D938DD13EFEE7123576608D9396F260907DA98AE2D3DD5822306CBC8A6 │ │ │ │ │ +B083C697DDA3C62EE7879436A9FD8EE0034B105105B3F122F893EA2126EBE8A9 │ │ │ │ │ +5CBF2BD248DD9FBEF0040C25797BD13B69A8C9F0D4E4F935C61ED30487CCDB1A │ │ │ │ │ +0339006E78EE1755929D2412776EC7DB1F666DBDD28EA8AC7397F809C7F38A41 │ │ │ │ │ +5B3BF6C75F4F35C90141EB08377AF452CF840FEA938805F9D14E02DC29215B4E │ │ │ │ │ +F1EB │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ @@ -5591,16 +5582,16 @@ │ │ │ │ │ 62 50 62 54 11[86 1[62 2[77 84 1[106 3[42 1[88 4[80 8[56 │ │ │ │ │ 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 │ │ │ │ │ -23[42 19[76 18[23 2[42 2[42 1[42 42 42 3[23 44[{}10 83.022 │ │ │ │ │ +4[72 75 8[63 10[27 58[{}6 83.022 /CMBX10 rf /Fj 138[46 │ │ │ │ │ +6[46 8[37 26[43 15[23 4[42 2[42 1[42 3[23 44[{}9 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 │ │ │ │ │ @@ -5739,17 +5730,17 @@ │ │ │ │ │ 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 1224 4 v │ │ │ │ │ -1389 w Fo(InpMtx)25 b Fj(:)37 b Fm(DRAFT)28 b Fj(Ma)n(y)e(17,)h(2024)p │ │ │ │ │ -2676 100 V 101 390 a Fp(6.)42 b(Create)26 b(a)h Fo(Graph)f │ │ │ │ │ +TeXDict begin 2 1 bop 0 100 a Fp(2)p 125 100 1218 4 v │ │ │ │ │ +1383 w Fo(InpMtx)25 b Fj(:)37 b Fm(DRAFT)27 b Fj(June)h(20,)f(2025)p │ │ │ │ │ +2683 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 │ │ │ │ │ @@ -5839,17 +5830,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 1224 4 v 1390 100 a Fo(InpMtx)25 │ │ │ │ │ -b Fj(:)37 b Fm(DRAFT)110 b Fj(Ma)n(y)27 b(17,)g(2024)p │ │ │ │ │ -2637 100 V 1224 w Fp(3)301 390 y Fi({)41 b Fo(INPMTX)p │ │ │ │ │ +TeXDict begin 3 2 bop 83 100 1218 4 v 1383 100 a Fo(InpMtx)26 │ │ │ │ │ +b Fj(:)37 b Fm(DRAFT)110 b Fj(June)27 b(20,)g(2025)p │ │ │ │ │ +2643 100 V 1218 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 │ │ │ │ │ @@ -5945,17 +5936,17 @@ │ │ │ │ │ (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 1224 4 v │ │ │ │ │ -1389 w Fo(InpMtx)25 b Fj(:)37 b Fm(DRAFT)28 b Fj(Ma)n(y)e(17,)h(2024)p │ │ │ │ │ -2676 100 V 125 390 a Fn(\210)42 b Fo(INPMTX)p 477 390 │ │ │ │ │ +TeXDict begin 4 3 bop 0 100 a Fp(4)p 125 100 1218 4 v │ │ │ │ │ +1383 w Fo(InpMtx)25 b Fj(:)37 b Fm(DRAFT)27 b Fj(June)h(20,)f(2025)p │ │ │ │ │ +2683 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 │ │ │ │ │ @@ -6020,17 +6011,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 1224 4 v 1390 100 a Fo(InpMtx)25 │ │ │ │ │ -b Fj(:)37 b Fm(DRAFT)110 b Fj(Ma)n(y)27 b(17,)g(2024)p │ │ │ │ │ -2637 100 V 1224 w Fp(5)208 390 y Fm(Err)l(or)j(che)l(cking:)38 │ │ │ │ │ +TeXDict begin 5 4 bop 83 100 1218 4 v 1383 100 a Fo(InpMtx)26 │ │ │ │ │ +b Fj(:)37 b Fm(DRAFT)110 b Fj(June)27 b(20,)g(2025)p │ │ │ │ │ +2643 100 V 1218 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 │ │ │ │ │ @@ -6088,17 +6079,17 @@ │ │ │ │ │ (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 1224 4 v │ │ │ │ │ -1389 w Fo(InpMtx)25 b Fj(:)37 b Fm(DRAFT)28 b Fj(Ma)n(y)e(17,)h(2024)p │ │ │ │ │ -2676 100 V 60 390 a Fp(11.)41 b Fo(double)g(*)i(InpMtx_dvec)c(\()k │ │ │ │ │ +TeXDict begin 6 5 bop 0 100 a Fp(6)p 125 100 1218 4 v │ │ │ │ │ +1383 w Fo(InpMtx)25 b Fj(:)37 b Fm(DRAFT)27 b Fj(June)h(20,)f(2025)p │ │ │ │ │ +2683 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 │ │ │ │ │ b(metho)r(d)h(returns)f(the)h(base)f(address)f(of)i(the)g │ │ │ │ │ @@ -6167,17 +6158,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 1224 4 v 1390 100 a Fo(InpMtx)25 │ │ │ │ │ -b Fj(:)37 b Fm(DRAFT)110 b Fj(Ma)n(y)27 b(17,)g(2024)p │ │ │ │ │ -2637 100 V 1224 w Fp(7)60 390 y(19.)41 b Fo(void)g(InpMtx_setMaxnvec)o │ │ │ │ │ +TeXDict begin 7 6 bop 83 100 1218 4 v 1383 100 a Fo(InpMtx)26 │ │ │ │ │ +b Fj(:)37 b Fm(DRAFT)110 b Fj(June)27 b(20,)g(2025)p │ │ │ │ │ +2643 100 V 1218 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 │ │ │ │ │ @@ -6262,17 +6253,17 @@ │ │ │ │ │ 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 1224 4 v │ │ │ │ │ -1389 w Fo(InpMtx)25 b Fj(:)37 b Fm(DRAFT)28 b Fj(Ma)n(y)e(17,)h(2024)p │ │ │ │ │ -2676 100 V 0 390 a Fe(1.2.4)112 b(Input)38 b(metho)s(ds)101 │ │ │ │ │ +TeXDict begin 8 7 bop 0 100 a Fp(8)p 125 100 1218 4 v │ │ │ │ │ +1383 w Fo(InpMtx)25 b Fj(:)37 b Fm(DRAFT)27 b Fj(June)h(20,)f(2025)p │ │ │ │ │ +2683 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 │ │ │ │ │ @@ -6361,17 +6352,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 1224 4 v 1390 100 a Fo(InpMtx)25 │ │ │ │ │ -b Fj(:)37 b Fm(DRAFT)110 b Fj(Ma)n(y)27 b(17,)g(2024)p │ │ │ │ │ -2637 100 V 1224 w Fp(9)338 390 y Fo(int)43 b(rowstride,)c(int)j │ │ │ │ │ +TeXDict begin 9 8 bop 83 100 1218 4 v 1383 100 a Fo(InpMtx)26 │ │ │ │ │ +b Fj(:)37 b Fm(DRAFT)110 b Fj(June)27 b(20,)g(2025)p │ │ │ │ │ +2643 100 V 1218 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 │ │ │ │ │ @@ -6469,17 +6460,17 @@ │ │ │ │ │ (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 1203 4 │ │ │ │ │ -v 1368 w Fo(InpMtx)25 b Fj(:)37 b Fm(DRAFT)27 b Fj(Ma)n(y)g(17,)g(2024) │ │ │ │ │ -p 2697 100 V 101 390 a Fp(4.)42 b Fo(void)f(InpMtx_permute)d(\()43 │ │ │ │ │ +TeXDict begin 10 9 bop 0 100 a Fp(10)p 166 100 1197 4 │ │ │ │ │ +v 1362 w Fo(InpMtx)25 b Fj(:)37 b Fm(DRAFT)27 b Fj(June)h(20,)e(2025)p │ │ │ │ │ +2703 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 │ │ │ │ │ @@ -6581,17 +6572,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 1203 4 v 1369 100 a Fo(InpMtx)25 │ │ │ │ │ -b Fj(:)37 b Fm(DRAFT)110 b Fj(Ma)n(y)27 b(17,)g(2024)p │ │ │ │ │ -2616 100 V 1203 w Fp(11)101 390 y(2.)42 b Fo(void)f(InpMtx_nonsym_mmm)o │ │ │ │ │ +TeXDict begin 11 10 bop 83 100 1197 4 v 1363 100 a Fo(InpMtx)25 │ │ │ │ │ +b Fj(:)37 b Fm(DRAFT)110 b Fj(June)28 b(20,)e(2025)p │ │ │ │ │ +2622 100 V 1197 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) │ │ │ │ │ @@ -6693,20 +6684,20 @@ │ │ │ │ │ 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 1203 │ │ │ │ │ -4 v 1368 w Fo(InpMtx)25 b Fj(:)37 b Fm(DRAFT)27 b Fj(Ma)n(y)g(17,)g │ │ │ │ │ -(2024)p 2697 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 │ │ │ │ │ +TeXDict begin 12 11 bop 0 100 a Fp(12)p 166 100 1197 │ │ │ │ │ +4 v 1362 w Fo(InpMtx)25 b Fj(:)37 b Fm(DRAFT)27 b Fj(June)h(20,)e(2025) │ │ │ │ │ +p 2703 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 │ │ │ │ │ @@ -6795,17 +6786,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 1203 4 v 1369 100 a Fo(InpMtx)25 │ │ │ │ │ -b Fj(:)37 b Fm(DRAFT)110 b Fj(Ma)n(y)27 b(17,)g(2024)p │ │ │ │ │ -2616 100 V 1203 w Fp(13)0 390 y Fe(1.2.8)112 b(Submatrix)39 │ │ │ │ │ +TeXDict begin 13 12 bop 83 100 1197 4 v 1363 100 a Fo(InpMtx)25 │ │ │ │ │ +b Fj(:)37 b Fm(DRAFT)110 b Fj(June)28 b(20,)e(2025)p │ │ │ │ │ +2622 100 V 1197 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 │ │ │ │ │ @@ -6893,17 +6884,17 @@ │ │ │ │ │ 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 1203 │ │ │ │ │ -4 v 1368 w Fo(InpMtx)25 b Fj(:)37 b Fm(DRAFT)27 b Fj(Ma)n(y)g(17,)g │ │ │ │ │ -(2024)p 2697 100 V 208 390 a Fp(in)g(the)g(correct)f(fashion.\))36 │ │ │ │ │ +TeXDict begin 14 13 bop 0 100 a Fp(14)p 166 100 1197 │ │ │ │ │ +4 v 1362 w Fo(InpMtx)25 b Fj(:)37 b Fm(DRAFT)27 b Fj(June)h(20,)e(2025) │ │ │ │ │ +p 2703 100 V 208 390 a Fp(in)h(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 │ │ │ │ │ @@ -6996,17 +6987,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 1203 4 v 1369 100 a Fo(InpMtx)25 │ │ │ │ │ -b Fj(:)37 b Fm(DRAFT)110 b Fj(Ma)n(y)27 b(17,)g(2024)p │ │ │ │ │ -2616 100 V 1203 w Fp(15)0 390 y Fe(1.2.10)113 b(IO)37 │ │ │ │ │ +TeXDict begin 15 14 bop 83 100 1197 4 v 1363 100 a Fo(InpMtx)25 │ │ │ │ │ +b Fj(:)37 b Fm(DRAFT)110 b Fj(June)28 b(20,)e(2025)p │ │ │ │ │ +2622 100 V 1197 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 │ │ │ │ │ @@ -7103,18 +7094,18 @@ │ │ │ │ │ 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 1203 │ │ │ │ │ -4 v 1368 w Fo(InpMtx)25 b Fj(:)37 b Fm(DRAFT)27 b Fj(Ma)n(y)g(17,)g │ │ │ │ │ -(2024)p 2697 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 │ │ │ │ │ +TeXDict begin 16 15 bop 0 100 a Fp(16)p 166 100 1197 │ │ │ │ │ +4 v 1362 w Fo(InpMtx)25 b Fj(:)37 b Fm(DRAFT)27 b Fj(June)h(20,)e(2025) │ │ │ │ │ +p 2703 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 │ │ │ │ │ @@ -7193,17 +7184,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 1203 4 v 1369 100 a Fo(InpMtx)25 │ │ │ │ │ -b Fj(:)37 b Fm(DRAFT)110 b Fj(Ma)n(y)27 b(17,)g(2024)p │ │ │ │ │ -2616 100 V 1203 w Fp(17)307 390 y Fn(\210)42 b Fp(The)19 │ │ │ │ │ +TeXDict begin 17 16 bop 83 100 1197 4 v 1363 100 a Fo(InpMtx)25 │ │ │ │ │ +b Fj(:)37 b Fm(DRAFT)110 b Fj(June)28 b(20,)e(2025)p │ │ │ │ │ +2622 100 V 1197 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 │ │ │ │ │ @@ -7299,27 +7290,27 @@ │ │ │ │ │ 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 1203 │ │ │ │ │ -4 v 1368 w Fo(InpMtx)25 b Fj(:)37 b Fm(DRAFT)27 b Fj(Ma)n(y)g(17,)g │ │ │ │ │ -(2024)p 2697 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 │ │ │ │ │ +TeXDict begin 18 17 bop 0 100 a Fp(18)p 166 100 1197 │ │ │ │ │ +4 v 1362 w Fo(InpMtx)25 b Fj(:)37 b Fm(DRAFT)27 b Fj(June)h(20,)e(2025) │ │ │ │ │ +p 2703 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 │ │ │ │ │ @@ -7402,17 +7393,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 1203 4 v 1369 100 a Fo(InpMtx)25 │ │ │ │ │ -b Fj(:)37 b Fm(DRAFT)110 b Fj(Ma)n(y)27 b(17,)g(2024)p │ │ │ │ │ -2616 100 V 1203 w Fp(19)469 390 y Fo(nvtx)42 b(nadj)469 │ │ │ │ │ +TeXDict begin 19 18 bop 83 100 1197 4 v 1363 100 a Fo(InpMtx)25 │ │ │ │ │ +b Fj(:)37 b Fm(DRAFT)110 b Fj(June)28 b(20,)e(2025)p │ │ │ │ │ +2622 100 V 1197 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 │ │ │ │ │ @@ -7502,18 +7493,18 @@ │ │ │ │ │ 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 1203 │ │ │ │ │ -4 v 1368 w Fo(InpMtx)25 b Fj(:)37 b Fm(DRAFT)27 b Fj(Ma)n(y)g(17,)g │ │ │ │ │ -(2024)p 2697 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 │ │ │ │ │ +TeXDict begin 20 19 bop 0 100 a Fp(20)p 166 100 1197 │ │ │ │ │ +4 v 1362 w Fo(InpMtx)25 b Fj(:)37 b Fm(DRAFT)27 b Fj(June)h(20,)e(2025) │ │ │ │ │ +p 2703 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 │ │ │ │ │ @@ -7579,17 +7570,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 1203 4 v 1369 100 a Fo(InpMtx)25 │ │ │ │ │ -b Fj(:)37 b Fm(DRAFT)110 b Fj(Ma)n(y)27 b(17,)g(2024)p │ │ │ │ │ -2616 100 V 1203 w Fp(21)1154 1747 y @beginspecial 47 │ │ │ │ │ +TeXDict begin 21 20 bop 83 100 1197 4 v 1363 100 a Fo(InpMtx)25 │ │ │ │ │ +b Fj(:)37 b Fm(DRAFT)110 b Fj(June)28 b(20,)e(2025)p │ │ │ │ │ +2622 100 V 1197 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 │ │ │ │ │ @@ -7994,17 +7985,17 @@ │ │ │ │ │ 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 1203 │ │ │ │ │ -4 v 1368 w Fo(InpMtx)25 b Fj(:)37 b Fm(DRAFT)27 b Fj(Ma)n(y)g(17,)g │ │ │ │ │ -(2024)p 2697 100 V 60 390 a Fp(12.)41 b Fo(testMMM)f(msglvl)h(msgFile)g │ │ │ │ │ +TeXDict begin 22 21 bop 0 100 a Fp(22)p 166 100 1197 │ │ │ │ │ +4 v 1362 w Fo(InpMtx)25 b Fj(:)37 b Fm(DRAFT)27 b Fj(June)h(20,)e(2025) │ │ │ │ │ +p 2703 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 │ │ │ │ │ @@ -8104,17 +8095,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 1203 4 v 1369 100 a Fo(InpMtx)25 │ │ │ │ │ -b Fj(:)37 b Fm(DRAFT)110 b Fj(Ma)n(y)27 b(17,)g(2024)p │ │ │ │ │ -2616 100 V 1203 w Fp(23)307 390 y Fn(\210)42 b Fo(alphaReal)24 │ │ │ │ │ +TeXDict begin 23 22 bop 83 100 1197 4 v 1363 100 a Fo(InpMtx)25 │ │ │ │ │ +b Fj(:)37 b Fm(DRAFT)110 b Fj(June)28 b(20,)e(2025)p │ │ │ │ │ +2622 100 V 1197 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 │ │ │ │ │ @@ -8295,18 +8286,18 @@ │ │ │ │ │ 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 1203 4 v 1369 100 a Fo(InpMtx)25 │ │ │ │ │ -b Fj(:)37 b Fm(DRAFT)110 b Fj(Ma)n(y)27 b(17,)g(2024)p │ │ │ │ │ -2616 100 V 1203 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 │ │ │ │ │ +TeXDict begin 25 24 bop 83 100 1197 4 v 1363 100 a Fo(InpMtx)25 │ │ │ │ │ +b Fj(:)37 b Fm(DRAFT)110 b Fj(June)28 b(20,)e(2025)p │ │ │ │ │ +2622 100 V 1197 w Fp(25)0 390 y Fo(InpMtx)p 269 390 27 │ │ │ │ │ +4 v 29 w(supportSymH\(\))p Fp(,)c(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 │ │ │ │ │ 269 988 V 29 w(writeForHumanEye)o(\(\))o Fp(,)e(15)0 │ │ │ │ │ ├── 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 May 17, 2024 │ │ │ │ │ │ + 2 InpMtx : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 3 │ │ │ │ │ │ + InpMtx : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 4 InpMtx : DRAFT June 20, 2025 │ │ │ │ │ │ • 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 May 17, 2024 5 │ │ │ │ │ │ + InpMtx : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 6 InpMtx : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 7 │ │ │ │ │ │ + InpMtx : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 8 InpMtx : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 9 │ │ │ │ │ │ + InpMtx : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 10 InpMtx : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 11 │ │ │ │ │ │ + InpMtx : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 12 InpMtx : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 13 │ │ │ │ │ │ + InpMtx : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 14 InpMtx : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 15 │ │ │ │ │ │ + InpMtx : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 16 InpMtx : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 17 │ │ │ │ │ │ + InpMtx : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 18 InpMtx : DRAFT June 20, 2025 │ │ │ │ │ │ • 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 May 17, 2024 19 │ │ │ │ │ │ + InpMtx : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 20 InpMtx : DRAFT June 20, 2025 │ │ │ │ │ │ – 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 May 17, 2024 21 │ │ │ │ │ │ + InpMtx : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 22 InpMtx : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 23 │ │ │ │ │ │ + InpMtx : DRAFT June 20, 2025 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 May 17, 2024 25 │ │ │ │ │ │ + InpMtx : DRAFT June 20, 2025 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 │ │ │ │ │ @@ -7,15 +7,15 @@ │ │ │ │ │ %%BoundingBox: 0 0 612 792 │ │ │ │ │ %%DocumentFonts: CMR17 CMBX12 CMR12 CMR8 CMR6 CMR9 CMBX10 CMR10 CMTT10 │ │ │ │ │ %%DocumentPaperSizes: Letter │ │ │ │ │ %%EndComments │ │ │ │ │ %DVIPSWebPage: (www.radicaleye.com) │ │ │ │ │ %DVIPSCommandLine: dvips main -o LinSol.ps │ │ │ │ │ %DVIPSParameters: dpi=600 │ │ │ │ │ -%DVIPSSource: TeX output 2024.05.17:2218 │ │ │ │ │ +%DVIPSSource: TeX output 2025.06.20:0450 │ │ │ │ │ %%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 │ │ │ │ │ @@ -3429,23 +3429,21 @@ │ │ │ │ │ /UnderlinePosition -100 def │ │ │ │ │ /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 49 /one put │ │ │ │ │ dup 50 /two put │ │ │ │ │ -dup 52 /four put │ │ │ │ │ -dup 55 /seven put │ │ │ │ │ +dup 53 /five put │ │ │ │ │ dup 65 /A put │ │ │ │ │ dup 66 /B put │ │ │ │ │ dup 67 /C put │ │ │ │ │ dup 71 /G put │ │ │ │ │ -dup 77 /M put │ │ │ │ │ +dup 74 /J put │ │ │ │ │ dup 80 /P put │ │ │ │ │ dup 82 /R put │ │ │ │ │ dup 83 /S put │ │ │ │ │ dup 97 /a put │ │ │ │ │ dup 99 /c put │ │ │ │ │ dup 100 /d put │ │ │ │ │ dup 101 /e put │ │ │ │ │ @@ -3458,15 +3456,14 @@ │ │ │ │ │ dup 111 /o put │ │ │ │ │ dup 112 /p put │ │ │ │ │ dup 114 /r put │ │ │ │ │ dup 115 /s put │ │ │ │ │ dup 116 /t put │ │ │ │ │ dup 117 /u put │ │ │ │ │ dup 118 /v put │ │ │ │ │ -dup 121 /y put │ │ │ │ │ dup 122 /z put │ │ │ │ │ readonly def │ │ │ │ │ currentdict end │ │ │ │ │ currentfile eexec │ │ │ │ │ D9D66F633B846AB284BCF8B0411B772DE5CE3DD325E55798292D7BD972BD75FA │ │ │ │ │ 0E079529AF9C82DF72F64195C9C210DCE34528F540DA1FFD7BEBB9B40787BA93 │ │ │ │ │ 51BBFB7CFC5F9152D1E5BB0AD8D016C6CFA4EB41B3C51D091C2D5440E67CFD71 │ │ │ │ │ @@ -3641,195 +3638,178 @@ │ │ │ │ │ 82032FBD2FCB6E403D34B85ED4053A8CB619BDD4DE001F4C3007B1F317579651 │ │ │ │ │ E6D6662189CC2D95AB85D7473F65C5D7B4AC63B0FE928F3400035D5A9D443D0D │ │ │ │ │ F3532B99F3AC26CB25EA3CD64C341159061E02EFBC7C033C05CD919BBD827A6A │ │ │ │ │ BFCF3BD739E32E7FE909AEE068D50FAC33605FFF98C7D0115FB860178FD03DB9 │ │ │ │ │ 7985B78E0AC21F2EA065FA841F5928FB85163B2E2D8F850DC7EE313912C45C28 │ │ │ │ │ 2783F6762C67882EFEDDC7E7567F91C16B16FD8D5A1ABF35B5586307701B91AD │ │ │ │ │ 54984598F2AD46FEE3D68A2731BEAA754C8E730FE0E84952EF77930E4118F8D7 │ │ │ │ │ -2F3AD7547BA1B44C698428BA878986BAD1DA8368E8F5B3774FCBE3C72540A92C │ │ │ │ │ -7BA6298D386975A4FE6B5612A807D5C03EE4582DBD9DD9BF6A01C6C70A9A765A │ │ │ │ │ -38D20AB1B02DA94DEF94BF1A2CD76923DACC5566750775CD474EAA165C02262F │ │ │ │ │ -2A896898A8F67CBCBCE53648ABE9CC1CAC420AAD2B48D9054F2A27FDA27BF115 │ │ │ │ │ -23732B2C0353E3035E724B186BBDB27C03905EF40F67F69E3F63A93FBEBCA436 │ │ │ │ │ -7803AEC143D8163B0686A713DDA163148F362FA5348389E0F834ABD204D14CB7 │ │ │ │ │ -AB6DFBFF780676E89ED96284B58545408904AD53098EE76659405336A5207814 │ │ │ │ │ -3FC60F431CFAB56AE03ED36E18D5B577B68431D905734282B590DB1CC6353A26 │ │ │ │ │ -58BE5C97A55E92ADDCD8D653EB41C38D55CE9E13F294A872DDEC30183118927E │ │ │ │ │ -5A666B87BFF4B6C1FC47420CF7F5F09CD664C837EB47F8ABB08D781F54ABB8BC │ │ │ │ │ -3DB89F3DD85939EC795AE70B3FD0841E79C6A9291688C40D6EDAF8C3562541DA │ │ │ │ │ -77D93BB4A7F4A8A9AC2937BB52FB92ED00568E59303B7A7977B4072E84E7EDA0 │ │ │ │ │ -AE8C199A9F9B243C57388C0D51A21B1B7B1F9B0994749F1C5A5F330F4B1D4E16 │ │ │ │ │ -BD58DD423CFE6CABAC756A9C0525F72745F77C4E981B4B46A769C5C497C79E39 │ │ │ │ │ -347AFC48FE4F89D25EAD7F8BAB714D2CD4676B51C3F6162DECB3470DF8F57831 │ │ │ │ │ -000EBC4CDF111B0E1AD72837BD7652E657C0204E119D3AC89284EFB3704BCD33 │ │ │ │ │ -00E7B2ECD9F2795B1D9F0C1DBE655F2C133B211C5664D78EA5B79DEE550D2449 │ │ │ │ │ -3448F8DCA52684207FFA56E5948AB984769A02C4286A117443A109D58D99AE71 │ │ │ │ │ -31593442B7301CE5AD314018CAF5D33B950491C9E8AAA1CD2CB91AE617F2CA0C │ │ │ │ │ -7D35F28E4A6B71B79ABCB34FF91308E9692036CB34BE6D6C311145DBEA6BD5E3 │ │ │ │ │ -147A533199CF8C5325CB981F32B0F5EA95A2E8C701F69231B0120913C948FF7B │ │ │ │ │ -CE668E135DCFBBA0C5D0E7C4269AEDD11858F5F1D39C35C3EEA6D266AA69AFDF │ │ │ │ │ -DC0761D3CEEB0326EC37DBA90D46A9D54600278A0BB453C0BF43BCBBEEF52EAC │ │ │ │ │ -305EAA30354A4AC54626C9F7E85811D712A5AE046A2EBCD7AD3050E68BE57BB8 │ │ │ │ │ -2844032DA1B2D2D6DAB959B205A078C89390619DB1FD4C711A73C4686BB3C4C9 │ │ │ │ │ -876CF1991254D36D97F477002F6D912D477BA95F4C499A8B8D6B7BC8ADA321A7 │ │ │ │ │ -06FE0D94941A0C5AD6A66F21DFF05DEE48F6681775567048EEE67DC174CF3938 │ │ │ │ │ -4F0FC0D9CE5797591E1E20F202321AE869CB2FEA475E37FE163E3219E3536404 │ │ │ │ │ -32A97D014D27AACA2123D0CA53682B8B7AD6A8535DF4E4E210A45E6B6A20773D │ │ │ │ │ -93252E8946FF694A00AD9F7ED0C6157D040AA62B096B777DAE9F1A9A070769A5 │ │ │ │ │ -F7ECF839C20B6EF3B2932011AFFFE8920B37B97ED98FCBE53BA7C062969EA78B │ │ │ │ │ -88E60786A3021F5CB49F4BFD3E866502860E9C3181E3119B4B7C0F678B86356E │ │ │ │ │ -C5D0B4BAD3006811E9C4065A03538A3A9396F7B4B5E0A5E5CF8BEEAA13421CCD │ │ │ │ │ -7ACD1C70C3C4F3BC6A03A946F2445FA9B40F9B1C1E81B08817FC6E9D487E7701 │ │ │ │ │ -1FD5D2FB81BFD29B6D9288B14FF9154AD4EDEBD88B3717CE43A16D71C9E6488E │ │ │ │ │ -C09AF555DC7B886CCD114DF70C6DE4443706644FB9FD76F5008E1343E0921405 │ │ │ │ │ -175CD0089D89133D72E3D0FDDB4E74C1B4FE2F988D32FAE6BAF080509FB1C894 │ │ │ │ │ -2A72F3EEF1E2C48DACABBCDD3545842C0814C22F2A81BEA85AA9A6021414C85F │ │ │ │ │ -E21A1E762707C2E1F6FF084141BE2DDA1ED4E58A4044DE3B403EFC6CCA78DB0C │ │ │ │ │ -094B02219F493930A61DBFFD65DEBFA1686E3D0FB56CC59E48726CF478E27F80 │ │ │ │ │ -58A7B6F64DE991181785CB174CB20A38A79224D0FF5A272A7A01E49DB1BADA06 │ │ │ │ │ -A483E8AC2548FA5BBDA5370DA455F0BB3F1067BCB727C89F86C54CF2B5449735 │ │ │ │ │ -E9FBEA7D590C9EA0B9655DA108D7601A5E1117C3D50AE986B095FEBDB0D21BE7 │ │ │ │ │ -CD34566C4C61593D1B3750228CF39F95CCD056C91394412691DB87912FB4124C │ │ │ │ │ -633FF59B0E85D3B8E3F47AA9ED9495761A571F3C0C645F47DE34E06FC39ED408 │ │ │ │ │ -53BB7E774BAD41B82E86AF9B395AEFFD53F15A4AB05FCCE6B3D43339197CD8D6 │ │ │ │ │ -2AF3508AD216CCF0FFD7EDB27085D4DA69298D8E66BCC4DA42D1A2C707CB7753 │ │ │ │ │ -B07DF42811317470005B43FC91E9D9C657A5AA937C384C0E6007FEC57E3F4629 │ │ │ │ │ -C1CAD116B059AD16881FA6E833E4C5CEC8A26D29FC5CC5D024C679DD18E3440E │ │ │ │ │ -156D6AEE59310CA79F61F111B69D021913F8D9DD6856A5E77438F818363EF018 │ │ │ │ │ -FCF9190B3B86C3353D619D6A9944E65FBF991C22D19C1802036F3B89557B42BD │ │ │ │ │ -70AA9F53DD2323E7337D1E0BF76248B02F9B5817B9C26026A02BADAFCD516377 │ │ │ │ │ -83C7FB6753B29D1091BC911DF4765ED4ACDBD3CB688B63CD1A347B3D51DB20E3 │ │ │ │ │ -89C1F1D50754B19DFDCAE36875A822740689563AD5938E46983B23F2DF51BDEC │ │ │ │ │ -DD71FD8438302ECF20CC46C09B6B072B5E49D51522D9591D229E0EE78A140F22 │ │ │ │ │ -DB083DDAB45F6FD51503173410B9C0AA879803BD5F6FC989724CC09D112E088D │ │ │ │ │ -22C2CF0134F4088A17158557F8596AB4C45D6C03CACF909E2D5C5AE6AFFF4862 │ │ │ │ │ -CCE22F88C3F1FD840A2FEA1480C33B5BD6E1CFBD33247E900925AB5E6C50C850 │ │ │ │ │ -92FBAEE82C3FFBB7E243FF7776022E5FCCA99D6C1D44EFC544A0B8924AE8BB45 │ │ │ │ │ -0885CFD771907711966065405B1C3AEFF8492CACA7050EA2999EB2CE3697CD67 │ │ │ │ │ -583FA9F9FDBCAAAD5E06F797B7C00357F351F5936A65C7E9803A01455FC5BA22 │ │ │ │ │ -9409EC542A1F8650FFBE18A35481217D3CAA1F513C1142EAD5B306DD4608C1DE │ │ │ │ │ -DFDE53AA1E8DF970A42B80CC09E67317670B670156298EA1742D2AA5F090FABB │ │ │ │ │ -A2C4A61C3CC692BEC3CDAA3118657D1F79A62F82A457DA216DB15381D77021ED │ │ │ │ │ -9612383B8A22E1FB0DD49E12794682CC67B1F6E0894CB5CBB6E3588FD42A0072 │ │ │ │ │ -7C9734051A7A82DDF237CD206F03CEEBBC9A9DF23790A3761F51FBC63EE78EE3 │ │ │ │ │ -56F6DCDABB88BA97D2A850EA104354E04829F787E8DA5A1EDD55F612BA0CBF10 │ │ │ │ │ -69B1551D3A9E2C53B28D81F78BC6FB5426708983FA1BC4B14D048EEFEC1AA7D8 │ │ │ │ │ -299E6C75545491B5E93E0CB089113EE54EB8EECB6133236F0EB2CE9382370FC0 │ │ │ │ │ -F8549DACF67B18E066A808BED7AE214BEB59A8EBE3DF2A8A1A1769B42A25886F │ │ │ │ │ -AA1E1677D80134FA9B13AFCD56337F99B777D5FCA1FE1D013B04E004BED02EF0 │ │ │ │ │ -D7231605D53F4188573AF68BBC35AFB2BDE1E589EBBBE498C537B8FBF1A62ED2 │ │ │ │ │ -7FA984809902A88812E607C4FA235724365CF17698476EDF387FA97D2C563D04 │ │ │ │ │ -60BC5AE0FAA18F56057BCF92AB0A09DA06F74927DA47B38A81583A4AD6C2A596 │ │ │ │ │ -6AF4B0AA613331FE73141A738593D8C7ACC8BD835D9411A79DA727C2BC7D9845 │ │ │ │ │ -509570B706F2527CACCB9AA6E7DDC7B5500FE5DDC2C261B92CB553630DCD5869 │ │ │ │ │ -F8988B8D62B8E20E20025B79261EF878AB175B85B6F5562397F8A824AB8AE86B │ │ │ │ │ -8E903B4884005E8FB2E6818F91C8AF3C5F42A3A14E3B6E6C22136D9B9EA71831 │ │ │ │ │ -75CDECDEFABD0DB4DB4CBD95844386E78099483FE2EF7F5B7F1F04FC04FE9A9D │ │ │ │ │ -A52285679DF98637150E2CC5D551E7771B5523D75338894ADDC067D5FC1F699A │ │ │ │ │ -EC28E341647E3E5CE90D7DE8AEDCEBD5501F1012176D387697C6651B39F16B0D │ │ │ │ │ -B64EF806974D6B52347614B6A2177BDE9C7A3394A7D8FC2B4B4938B7F4D5499E │ │ │ │ │ -C6870490639991D32D8493CF53A3999B5B506B6A48CB2F520179801482C555BE │ │ │ │ │ -B0BE1481C73D31C633398EEAA0BBD8BCCE3052299AEF4A850A2A3269C7E65260 │ │ │ │ │ -463C240D4E24F6BF709D6609E25D2D12EAD790EE73C83C77C283CF0239EA97B6 │ │ │ │ │ -59903202A9E244945C2900F282A20A881F09BC8B359C2877B555B563C62E6237 │ │ │ │ │ -D9FFB712A8364D732560813C1FE0346627D008268A9EAF73ADB76D0A8E6BFD5A │ │ │ │ │ -D67FDACC48B234DBD8E3FA6A8D8209CB8BC01CBF67436C48A40F3ECD9C2B1FDA │ │ │ │ │ -2F2FA8B74FC913A5C3D427FC85426C2FAB3DB2FD347E6EAB8AB10E93931BAEFC │ │ │ │ │ -C9992805128A797065933198727908EEE728D547392D5BF8373CFE9EE2EE18FB │ │ │ │ │ -5A039992B506035E3CC68B63200E3602D7591F72FBD354E7F58D689FD128EB4D │ │ │ │ │ -5B5B5B8AA3ACA2D45EAC143B799634102A2DBCCB62C11B0E9CAC8E767C0C4C88 │ │ │ │ │ -A2B5ABDBD0297D09464899126B53D62AA055CA3003DAEE3EF25F0287FE8F8F7D │ │ │ │ │ -7386EA78643BE5CF740798AEF42BCE6447027B2B6EEB3FF15CC413DB278D44B4 │ │ │ │ │ -B9B34DED4BC09E27EB2794064DCCA7FAB4CC07B5EED3BF7FF8E9510FB7075D43 │ │ │ │ │ -D7D418E490BCE220FEC920BAA447E7C80DE917AE3FBBB8564A7D4D6288AC5993 │ │ │ │ │ -B862CCD37368F61324B0F048C2F099F9A9316032712E4F0055E706845B7B7FC9 │ │ │ │ │ -5B5333177DCC0FC7B9072EDAE5E5B8085DD7366B26F8885111787023018C95BC │ │ │ │ │ -1C5079C29D50F9C3EAC14838A8AAFC516BC5071344833057983A80D37790CA7A │ │ │ │ │ -D9FC87A39C42212262D84198E0B47C974EF5DF67A9D9C00EAE26A04CE66E53A4 │ │ │ │ │ -84D7381898F9A546990AEA4F100472B057F516683B915B67BC004AF249C66EEE │ │ │ │ │ -17B98421168B60868B9AB3773807B1DB44D51787BA9027C34F84F136882DDF5F │ │ │ │ │ -A9448182BEEA401D78770EE17AA0A75161197D82C33F1CE6B5CF1DEECB9CE62B │ │ │ │ │ -FC4527822ED9EBB8FC2E18729BCC4857917DC8DDA51ACA3977DC81C114D96CDF │ │ │ │ │ -7C97125F09443AF0676CD85A376DF66AE437C6AA1A4216CAE82779B216785FBB │ │ │ │ │ -D7C90E78D25070C94F30AC415A5F2D2F41F1D31775A02846BEB57F0E18BF73AC │ │ │ │ │ -E474DCAE6C5D1C1AC3EC94174AA184DDEE836451827D67B446D66B4C6D64D198 │ │ │ │ │ -9F1DCD8CF2EBBD91517020E8755A95AF1BB1D55FC51C6BA0BCF1F11BE56B3450 │ │ │ │ │ -1CA69DCF757897D6A025691A1BBF6940DF49956F6F8E8AD1A3DFEA4F80CE893F │ │ │ │ │ -DE03E865684548ED229F7F38A0B1D6B2AEC370C7971E4ED4459EEBC23CE21CC9 │ │ │ │ │ -C310644F6228D73B8F44944553A339A4F570B73A182EB69E0CF8C8D5238FDF3A │ │ │ │ │ -A1F8129A11EB9BC0AAC32CEC29D51213FD4406A019221C03FE875619FD459CCA │ │ │ │ │ -CD6B7B42DEBCF36AA6A32B9D63B6FF8E69FF659DED7730F2D621815459B3B956 │ │ │ │ │ -F273DBA610C752C4FB3A5DF5B141FDAA7397D6A149031237D78308291F28B2F7 │ │ │ │ │ -2F2ADD3010D86D952877B2012A1A4E4BD97C81D5D21F12C2D1486568A8E2F32B │ │ │ │ │ -0C0649028AAD45E085F129B194EA7A4F1FB7406B804C358A1C7A13CB3F6914D2 │ │ │ │ │ -7FF1CFE69C49F45F131CB5C0157FC87C7FF41E2A22D9013E562BB6CEF0BE4AB8 │ │ │ │ │ -950990974627A4E670588B703A90A7E1C6390CEB2D2B899A929241C8A0AA8CDE │ │ │ │ │ -E5E221617517475BE1809BFA40CC6E79BDD64D2AF74F08EC34EE8B1CBE900E70 │ │ │ │ │ -CD51CDD66E60B5CACDC956C986DDE4242B828434A48E80A55586A3081284B91C │ │ │ │ │ -A1A19B6CC08683D20FA17D32F60E4D2ECF6051AD72CD0021E4B722296E173220 │ │ │ │ │ -48C22008BEB8991ADB83A06E3CBCB101EBC561CDA7D32B6476A4EEC7AA24F63B │ │ │ │ │ -7244E630A0E4C4AF56932A7DE238127ACB44F5F14298DEE2E132A3CADDB680C5 │ │ │ │ │ -DD71948FACD69024D0136F64201107E935F98FE448A2103092960D447E007E89 │ │ │ │ │ -3EFF807BF973971321B4D418B9031B524A9EA76E36DF8FD6006590D3EA8D0018 │ │ │ │ │ -80D27C0F7D73A25998D445275B2F67E236EF2073F9EE50AAD05013CCBF0F69E3 │ │ │ │ │ -D3D5AB03A3BFC509515559DAA64A59FCAEC998C7015DA328F03E28B3DD69033B │ │ │ │ │ -64977C17AE0FD363012A4E30BB8BEBCEBBC73EA838666183FBF26E5BD2D57AD1 │ │ │ │ │ -8F8053456EF965F8801FF1E8554FF13DEA6B01A252F80E40F4143AD8744A4596 │ │ │ │ │ -531BB38459425D8AA67AA928374381FE046748945F1FC2025096352E35205B2E │ │ │ │ │ -123BEF4F9E2AFFD6CD9598C54BF8E1D6907E019873777A534D066ACA6BE8D449 │ │ │ │ │ -41EF20ECE89B1C61D1F6EAF93DC327BF7641234587E0200EDB3A2C7866C9D514 │ │ │ │ │ -15187F2C34B46E82AA0E9BEB413EF5F9269FE5E876DFBA5143C51BC449F1CFE3 │ │ │ │ │ -AE6C98B5E14A63175B469977AD51E23EAA653170272D58B91D790F115074E137 │ │ │ │ │ -220D92D55C11996B4CB041718DCA59562A434184F6FEA8F089F76C879DDD1113 │ │ │ │ │ -ACCDB61B75C529C87D474261780BB9CD7B1F6A280F86C927846B01A88A03A580 │ │ │ │ │ -1002B9AE63A57FC1CE97D16D12FB3CA84861323A0A7ECF9079CE48DC9983E95A │ │ │ │ │ -3E82B24A584B98E2CF8049E837A0C85DE17F1C997F43A8EA62F890E894A69D7C │ │ │ │ │ -1089103E14B5459C4F44C09C5FBAD7618A73BA524147BDBA9903E1AE4921CFD7 │ │ │ │ │ -4D2728B3BF1CACEEB01E9E810EABF3B20912F3D0CA324BB2DEB99429B2BFA724 │ │ │ │ │ -5777F6E931BABEFBCE36B9056580C48BD58CB527633D9DE6CE761A0439EF8F1E │ │ │ │ │ -72D289396A2649BD18BF149035F233DB4BFCDBB898199FF3A48D91C0CCB39080 │ │ │ │ │ -4F1B279E6F1C7C8DEDDE49D68F2A651E0A6C8FBC55810D61B9635C7533646DFA │ │ │ │ │ -C089173676FFCB1DF7E20E0666A41C7627C94B3F3B478FCF43A65F527E8DCB8E │ │ │ │ │ -8BF0415235949488035716462079507E29B1444FB1A549D394CA4A19BD93FB16 │ │ │ │ │ -50663072891591147C2CE996C0AFB6099AD761CED10F10DC257FDC3E0CD0BB44 │ │ │ │ │ -2D2D2A8B4DA9D4F5EF66AE6D07B6AE079B74066BD86340C744E07A72117E3C71 │ │ │ │ │ -D2181EEDED7DBAD6C2DCC05D72A06E13933D6A161E75633AEB25D6CD6F66D382 │ │ │ │ │ -DD76B29F08EDA741A65986D5314A805543704C287484781550FC5271275D6A13 │ │ │ │ │ -89B4EF19189EB11A10318A4FAE5E5ECF96A7592CF6791A2618714956DB19A54E │ │ │ │ │ -7D107DEF07D586F8024049FCD10383500179DBEB5CFB1E260384A5192CED3B71 │ │ │ │ │ -03A34AA54EAD92DDEE67E563C0CA912A4654CA5CCB86DFD726BB518C881E40DA │ │ │ │ │ -F5005F431A69764EF2EC37796032F78D7D4AD2D1BA38CF82F49737807E375DBF │ │ │ │ │ -26E2217A9D5691ADE3FB78AC897B000196D179DA4C1E7F5CED69A3592212917C │ │ │ │ │ -BC889CC68EA9CD5270135FC5436B4BC0D58F01C27293524AEE96309AA9642D83 │ │ │ │ │ -6C61254552FA6A50E796683E984EBB8B43F1BE8D1B0D48655C8AB778DD878A0F │ │ │ │ │ -28F6A5E880B11C931EE3BC6C5667082CD7737C6CB20F307C0F59500B5F933DC7 │ │ │ │ │ -02CDCEF0A303292BAF4D6D99D0A52A718A3A66CE9CCDE08E60B003D94CDD6850 │ │ │ │ │ -4B4B0CE48E8F79FC05C8916DEE472DB19034E73BA33519944CA36C77139B9508 │ │ │ │ │ -18429BE5344623126B3B100C608D524F6735ED9DE9C44941FF4ED88546EDA536 │ │ │ │ │ -74FF8E466978212E936AE3B0871FFE5E977F8CD99B3BD961A803CF75B0A78320 │ │ │ │ │ -9EC7735E07A6E9EA5F0E633DEA5E6F6CE64C0FF321E077A781EBFC5F544E5D9F │ │ │ │ │ -46AFB78D6DE8AD9E7AA40F40547BADD8108FEC64BBBFA21AD2BD16D51963776D │ │ │ │ │ -32DC2D3E3400E9A7AC71ED7AD30CB99FA520D246BE459735A64D4A78FC3B0DCB │ │ │ │ │ -6EF78332585EE3580DE2E8E18F36B97C32C0FDC1B00E7A39CE115C2291914C68 │ │ │ │ │ -10087D2021EC0931EFBE2D41B61028602ABC2D5BA7FEAC5A053E840C3F940368 │ │ │ │ │ -3E22940575476F63CAFD83A512079E4B73CADF8F4E0011F7810007A4CEBCCB7E │ │ │ │ │ -1BDCE1C75B50FC40DC7C7A3AE10F50FBC452DC1F3882250020173ECD94F50496 │ │ │ │ │ -FC11E83AB5B1F1AA3D6C01EE26FF8BECA33D350564ED13CA12A049DE89BEB09D │ │ │ │ │ -273405AE9353B7417BD360CB65829F30BFDFEEF15ACC8664835D1E4939A74974 │ │ │ │ │ -99E8876903A5265503D7E956BCDA786394A09F26CC364E1C5757C263E82960E1 │ │ │ │ │ -AE323589E24B96FBDFC01F8B12B7CE4211CA64BB8B3A1D9222A7D90CBEC284AE │ │ │ │ │ -B7DD9EDE680FA70F221FD85E782566A893C382254FE608630610A2F40D684FE3 │ │ │ │ │ -F8AE46090884B277EC4AF5F52C22BF6CB2691AFD1DCF2F58D2A4290B5562143F │ │ │ │ │ -7B86A0A53AE36A459DDCD273EB6C5E74C8B12C06147604E9AFD3ED6B490FE809 │ │ │ │ │ -906DD45CD44C7131247EC1EBE5158D1C1850A7923355D98E574161EBCBA074A0 │ │ │ │ │ -9452E8B58DE6C70A9F539BEBC7133483D1E43471B4D557553942B379B75F3354 │ │ │ │ │ -7C814EB47389B273926B0F5E1D82CACC4DE89090737AFA0FEECBE76595FAE393 │ │ │ │ │ -2E43273D083625F0A71E378348DEE9F4A6A203D68607DA4CFDA5C26E0DF5E8CD │ │ │ │ │ -E2FAB1F484067DACB05686C0A26960DE3B46A995FCB26F11ACB9700EA8CD7156 │ │ │ │ │ -19A01335 │ │ │ │ │ +2F3AD7547ECD7EB31108291A22BBC656F4D968DF891E4F87EF8FFE711A48FFD9 │ │ │ │ │ +94762E9918C42251D75772AC97BC15A4FF63D911D96AADA1CFAACE8D7001935C │ │ │ │ │ +9D7A0E6B35E1522780C2629D74057738FCE1BD41CD81D97BFD99D19FE03B2EFF │ │ │ │ │ +7B80B18DA5538D06A810DD315F31DE1331EDB82DAC760E6D8A855FCA3C8DD9E3 │ │ │ │ │ +61164D1386FCA2A0E7735AD69D7D9C6335F02064419B2296ADA17DC51A1E2195 │ │ │ │ │ +45FA3A158E075213ACD6607B07385F0D9F5F3C5C385624B43B10016D497FA569 │ │ │ │ │ +103C0A7CC701BF1558C587B15A8094D8E4524D74DC263BE9C5D1C96970A7324F │ │ │ │ │ +5514ED0576D79D5A7C8CC2859C832B0C5869166DA1DB8CAC589AC9EB48379CBB │ │ │ │ │ +33B840FDDADDDA5FFFC54678E901A33854A703C01C16945C99655BF1BEA74EDA │ │ │ │ │ +723B5FC176D9693ACA831C563CDB35C96C69575A510E33D5BB62701CC6CF52B6 │ │ │ │ │ +0DC2562927C51CEE40731A968C796BBD399BFD4CF070FCA8E806F693E20AF9BF │ │ │ │ │ +64FECE20D4E0C6CA2A65F219F242989DAF5EF91F938A2DEEA46C955E8CA1B9C5 │ │ │ │ │ +8009E9BD1BFF6AF50E0EA9BAA0869F4377633A88B45E0213ECC54844CCEA9D84 │ │ │ │ │ +1F6977C49C4A8B7534547FD77218695D18B20D2DE3AB9E395FF3CFAF16B68567 │ │ │ │ │ +1CDD1815897177510547D05A6DBECB4043CF614D08EE08FF4FB95130181253E9 │ │ │ │ │ +B9CC2511A4C356839E7FCDB340CA4B0F41D40045C8200FBB53F2432776057381 │ │ │ │ │ +8DDB50284E25720965F2C64AC7C1AA354F32CB5F27FE35B607E2B0E6887D2BC0 │ │ │ │ │ +35D7DAE239F77513D5D5A4346D0A8451EA97085A32B1AA49F3B90C719937CE3A │ │ │ │ │ +D5CA5C64D87FC079F29677332F9A52B0DED7BAC119F6DD494E29E349FCC219B8 │ │ │ │ │ +03260C5020104E6F95254079532E34174C898765B4E18AA8B06EA0B1C3F4B871 │ │ │ │ │ +4DB0621D3F6557A781788733AE4348FA2C7AFAF2EE0FEB921C71A43EE757ED2A │ │ │ │ │ +61E6008C2A3725214C8F5C8CE701BDF2C611745BB0948C6B37EEB566A4A5E30E │ │ │ │ │ +00F04F71BC515E5A6477CB85FCFA3FFC928C283F3FAE5726C4027D13DC6CBB54 │ │ │ │ │ +932715238B4A0574AF2924148106E8B957F57AD9CA9629A1074DFA3994087C57 │ │ │ │ │ +329F507E9DED1324E3663E4F7C38B427DDDE7CEBD8C35C0407DC065D23F97F14 │ │ │ │ │ +31A8E1815410FF5C8BF11B52E5F512E8B3B0829A4AA8AF4EAE6529BD9B8F3659 │ │ │ │ │ +7FB793DF49C196382D5B5148DC7108BCF8B44CB4B3C5AA0C439BBD2C6422340A │ │ │ │ │ +8E182BE7BA300538E34376AE882340B894460B1E0D9DE3A991F804C47B477DEA │ │ │ │ │ +5BD0C84085758D49CE07427C96135A868BF8A39FDB4F39F0D9C98BD7A5F29086 │ │ │ │ │ +C6B943397D67A30AE070E5FD2B7A0E7170B15254B3970AB4C8B4E92D41C9CD93 │ │ │ │ │ +E22F4AA8282269A40C728E0D1006EAC5035A51145F0B1A481D45C633A4C77356 │ │ │ │ │ +F1E686CE2B952B3A8949BACD063BF21C9522ADC728BD5240AB3EA8CF899D7E2A │ │ │ │ │ +A02324FB1F1499D2A1B0082D0A7134DC6A73895157FBC153BD3051064B3E173C │ │ │ │ │ +14293AB34E6E99C1E80C2409FE4148FA189AD22FAA20EB9E0F7223CB552BF5A9 │ │ │ │ │ +5DD8F8F9136F7CCDEC6BB386B7C3CF948544E8EC2A3D4027F7DF24738DAF6AD9 │ │ │ │ │ +693DED5FF1CE85155D88E596DD1C93A7F8B0938B9C7EC010F53CB457D6FCAFE5 │ │ │ │ │ +EFFA5D2B9C0454DC098A57056291BA0304AADE693DAF06510E16CAD17E73B5C0 │ │ │ │ │ +7287DBD0CAAE8FB9250CAD4529BE16F9E7F1477A7FB80686C7F43B08DC51F926 │ │ │ │ │ +194B713D956070C6C82FB7CE5E61AD6C711C542A47610ACEF0342E7B9BEF6D4F │ │ │ │ │ +8C6FBEE0CBAEE4EBE65D347BD2CB3C01A182FF48CF1D92A5EA0C7A4A6DA5B712 │ │ │ │ │ +C173181958365447E88AB50B7BB8E0B9D52444E21093B446521EBD6B9AF99F06 │ │ │ │ │ +46D81BEA7DF141396314D4330BBC0A24097F0F4301EB5C07E89857BCE30E3315 │ │ │ │ │ +7738D84EFD632C7B94457B9ECBE6AAD9A8D9D0E50CAA60E44189B062907C8DD3 │ │ │ │ │ +49FB1E495F42EE5981C1658BD4063002AE965C612C7C5003C0B2E70442421267 │ │ │ │ │ +C09B4071FAC531D17ED012131A91B90B9DD1F3A04F6860034809EAB492FFD6DF │ │ │ │ │ +ADAB62B7D7372F4DF438D8C1A2ABB4FCBBCD3C0F12C7F0B82D06FE2903A31581 │ │ │ │ │ +4EE4A0D36C472B9BAC2DB0BF0926B4A1F6D786FC4B50E6759147F704EE78A7C6 │ │ │ │ │ +6C4413487D3432EEAF07C97955B7A370C45A69CEA161E7D2285C2E5175C3B46A │ │ │ │ │ +BEBCD9119A777E74EBFACE7C8D51B057314197085C234EB51EB6E52C684088B1 │ │ │ │ │ +44FBFE382CC063CC37879463028BB7DC0BC95C32F17B8C0C6E3E328162C25C10 │ │ │ │ │ +61E6CF161DDA9229763E33C7636827BAFDFFB905B43F71147EA1D349DC608E40 │ │ │ │ │ +D3A0F5B2F77CFF4342D3392CFAFEB1317EC988D3E25074EC8C53E2447F61191F │ │ │ │ │ +753DE227A94032676EF0D2E167B57EFE3FA0B8FA53968A8F2F0A78F6ECD9F869 │ │ │ │ │ +18141E74690EDBD03C066E396551F7C82720BFD06636F3714BB3B9081167190C │ │ │ │ │ +1ED6C4E152F6AA2D2A9D30499104E12B649781D68506C32B2EAD9218577948C4 │ │ │ │ │ +D092971B380C88073436499A891A5F409A61D330DD6FD442B6F349132F233ABD │ │ │ │ │ +87A7DE6B25642F7EC8564C3AFF06974FB00BBEDA38F03EF6EBCBD97D646254C3 │ │ │ │ │ +AF094359D78A00589DEBF0094AC65958DD6AE8C53C015E2210FCF31D9D4EDF99 │ │ │ │ │ +6252D0D674384AB87750F4DFD0AA4331B9BDE7D229F2BBBC3706D72EA9818792 │ │ │ │ │ +CAA8D6E67246375032924FCBBA3936510CE66B7D605ACC51AC4F2CDD53B537FE │ │ │ │ │ +A503C6CE3807DD0EFDB1F88F00AD4A72669B7674C64529FB2557053DFF065524 │ │ │ │ │ +7EA77E9529D9AED778987329E3144106712967AC2A2B7FFA3342F5F669788BB2 │ │ │ │ │ +87FABCF9330854D581B7B8E17175C8EA5084E4FE1AC48CF2DFEFAD1D38E29D80 │ │ │ │ │ +CE2C2CE66C7722BD981BA92566913FBF5765E6468DE60E8410DED71E1F975265 │ │ │ │ │ +0B9BDB4A6BFE605956A5ED4FE12ED9B8FF84B495A2C88AD6208286E903CF8456 │ │ │ │ │ +BB3BA7C76A99015E0B215948BD936D9D9BD6F52ACB36A4F17096D5558602BD6B │ │ │ │ │ +ACDB0CBA4EBE7656F269E1FA7BF19F87E2AA1CBD9F683E91D2AB4D279F0006B9 │ │ │ │ │ +C6B6347B60F56BE3BECBCE7C2A52DDE47622B1569243BC4E334803D6C6A8157A │ │ │ │ │ +6FB196E942D363DFFE33970919AFED1F7158503807A020F1108C9331FD989D78 │ │ │ │ │ +D9BC3C4716407B22A304F0A75EEA455C2D3085A5A4BEBC5F494B5A059995C68A │ │ │ │ │ +0334292F9D0B760EE80D64748705766EF1A54087D8E980A48FC430FC388EAFCF │ │ │ │ │ +512498DB230830D94614ACF1393853C8157E690BA970C7311AA619DA8707F86C │ │ │ │ │ +B8614D6EF131EFFB7FB995D8D70E0EFE1E1B5DE368A0D97AB8D9B563CCD6E72F │ │ │ │ │ +16E93712E731783E6B97DE6C9C6CB194D46CEB1FC2875BDD1126188BF57023B5 │ │ │ │ │ +F7C0C1F8F4421FE0D0837E3F370B553B91C4D01782E74D45DD4C68EC0A3236C5 │ │ │ │ │ +910B689DC3C3FA5D90B128BA9DCF6BC0697B3449E4CC1C10499B8367893A6296 │ │ │ │ │ +CB18D4F3EE9128C3352C3AE8FA64F908F3EFB1795702E9E91E3AACD0942EC894 │ │ │ │ │ +03FAD8FEE0AE6E4C8AE7E9E31DC5554AB309145225705480F48E9D8A1D4B648F │ │ │ │ │ +1B13A8A0629FD99636596AB13A7BAFF285AE08E368090C5669DD822E24A3DA30 │ │ │ │ │ +4D5CC27D324823906E512CD9361993C0C5EFDDDA76A63B0A516202FDA0032076 │ │ │ │ │ +0E18B5642BF54944DC435F791744509FA8B569A0BEE7598906BAB10DCF0D68DB │ │ │ │ │ +113BC4F575D896653B027BC10CA5DDA109111D93CC4860B0238FDAF66D6ED16E │ │ │ │ │ +7C8464CD6D027E5DABB693062F42631A48C8425BC390FA1B40B08A803CA11CA1 │ │ │ │ │ +1C925F5ECA78EBDC6B86AC2DBCD015EC7380AA488A68D5C59F8C6FB4763D67B0 │ │ │ │ │ +D6036DE8D15E323D29D9F7C5EC7359C03C9E609EF3585230EDE6003999B8A057 │ │ │ │ │ +B2AB7883470ECFD990233725D126BE4DFEFC5A0E943AEF027DEED5D890904B73 │ │ │ │ │ +B72BB40A57F475090C1E4C8601D627EA8E21BC4C4D3C6BBEF7A13B88C5D40DE2 │ │ │ │ │ +D0846401148D9C00FD15EFBB2589A3E22298A6AD85ED9EE64B8328D8DA652B24 │ │ │ │ │ +F6A519AD62A390C748A57600AD6A5D8EED743E08D752E4417006D6928C69DFAA │ │ │ │ │ +359BBCE06D4AA81EB80FE6DB6A74BA14A77E52C883E9677E9902F69E2E5C2FEE │ │ │ │ │ +46D1434985765F63FFA25CFC769AE010368E509F45FBACE97488A52D224C1131 │ │ │ │ │ +629477A3BF9E1E7B36823C3333FA7657FD9AFC97CD2D9A8DCBBEF0367AF4303F │ │ │ │ │ +6DA6BCA99B28CB3A9860373949870B25DCBDC2EC5F36BAF1F4B526C20C7603B3 │ │ │ │ │ +2801EC79B972EED45AE9A85CE4B4A761580F07105FEF57300E950A81F72DF88B │ │ │ │ │ +D8F1C6800752ED06B447CC8733141B82D7B6F3ECAF0904DD070DFEC5E1B22FBA │ │ │ │ │ +74B10F9A884659967588A5F976E3FAD2ACB4308BCCF0A4291EE9D3CDBF9F4A1B │ │ │ │ │ +F11FC57BB6561FE90EFF9E0F50CBB86ADB78D2BEE705C1BB7383D62DECA3579C │ │ │ │ │ +1D8344D140E6891FCAE28BC32E007206913FCBDE15B20AC8FFF57A3C97AE36B2 │ │ │ │ │ +DAD9244B6CB213CB72D4D01A47874967EF94A7836E23B81EFF42BCAAA3B05278 │ │ │ │ │ +8C9D1868B71C235E3681A45B6BD8C4BB399F8A7D4946CAD616D3DEC3410C9849 │ │ │ │ │ +001B9D85B9977DA94452C31FC1BB4A1951E4D4208303F8B2398F8855FFC1E465 │ │ │ │ │ +A09CF0078EBD1A0D839E6CCD31E1B3C5D46CC874FF8FF99463D65D4B32431BA5 │ │ │ │ │ +A27EF795AED10B34F1944F38B32C23360317A53EA04BFBB08717D39C27EA0F9B │ │ │ │ │ +63763D401FEEBD60A3E17A7BB6A3D2ED0284ADDEEE642AA8A3D806A8EE044BA4 │ │ │ │ │ +5C7F2905C0B81DC75EF76B5F7B88EBD8A7D96689305349377F56B0C4A5F4864C │ │ │ │ │ +3B32934506F4C77C022FBA1A798424ABE5ACE30D40636C865E1C6C6CB20F4E6D │ │ │ │ │ +9B9DD8E3B127EC6F2800BE090B8E22ADAE5872B416DBC434A5CEF9DAEF55B0D6 │ │ │ │ │ +5987E79E4787711756647F0526905878440F452E03601970F1FEFCF0B50C83B3 │ │ │ │ │ +E3F00935C9698243F93B3BB239B9D0B773135A1A0AA158483E4D9DA97CA05456 │ │ │ │ │ +01DCEA0F96B403A65737B86246134BCF388CA84C6A3F3AB5D0D44E355271C46C │ │ │ │ │ +5924E61C8F78F151FB95B488124CB913AA218FB097DC3564ED75E349A1C0BA52 │ │ │ │ │ +E4CBFBB743970367D510AF391F0B5C8FCD03B5F04FF262F3C3568540C3958023 │ │ │ │ │ +9ACAA980BF675703E40CDB19C6E8F8C45057DDF12BD03B7330B8F88978DF5BF9 │ │ │ │ │ +6E23D014079848F8E23F71232C35580C1C7F544B32EA2B47FE8B82315D47F51B │ │ │ │ │ +557533D023C568CD51B1111B0DD88414A3ADF82AA716716C1296CA3C9AE06E43 │ │ │ │ │ +79B6EFF98C870BB8F9EC8B8D48307AD76CF3E34F3B4DD6F1B2F7533B04599F16 │ │ │ │ │ +72F5D7278419D09E81DC6DCBF6990D78780936183CB71596ADC5596A368A17E4 │ │ │ │ │ +09A13AE79D4DEF730DDA4D6C01BA170C8F75C7610741587F2B38F69E67F4B0B6 │ │ │ │ │ +4022BCE5AA3C6377B1CF1B6025F408C19A23F157CB8A06B69CF23F1E42949683 │ │ │ │ │ +2AA10A048C24FF0A3BDF52ACB3C7EE9754FDB3C8F963C33EE7951749FC6397D4 │ │ │ │ │ +A9F042676EF434E4C7A1D772CF683EE4E8F08407E012EFCFE7B33ECA6A3FBC1D │ │ │ │ │ +6E313EBBEABD0265D1420FB0DBC417288B9E4BA8EC2AD88FCC7EFE6E773400CA │ │ │ │ │ +C4F9961E048A4CDEFFE3D1CED8253E04C626B5472DAD58D9F5E37DBB6D1EFF5D │ │ │ │ │ +883C3519867225181D74BD02FAA271088437830B23F3DDDD883AFEFD5F062163 │ │ │ │ │ +F83E2A15CF7AEC82AECC37FF9E7DE7B087A54A10368E97169F4003F732A754A9 │ │ │ │ │ +F8E3D81146A1BCBBF4DEDFE47BC1D63E6045BF7A616E39BF373CEE53C866380E │ │ │ │ │ +699658B115C7D8811989F952BD3347929C78480BD63FF4923F4F528E1B01066B │ │ │ │ │ +A36B19BF17F83BF910CACE27BEC18A769B2778E7F9D220BA5AEF1CD45E382BF0 │ │ │ │ │ +63A169926D09D19CCFF41536F21BB70C78D588786C25744824B6DE76414821E9 │ │ │ │ │ +A7652E3F4C69155D582C8BD54B7011C98D3D664B96D097693A4B5BBFF9F7CCE7 │ │ │ │ │ +FAE34C6E4978144A7BC81861E93B779327CB72198C17BE57BC5C4B1A574E563E │ │ │ │ │ +1AEE7F2EA962EF628781BB6736D37351DF0FDDF20DA267A1983018CD9BF12A00 │ │ │ │ │ +DAD47DEA0EA31E7F876DB52A68A520897FC70A3578A84ECA3A44CB0B2880A2AE │ │ │ │ │ +AA2F95E4794225259898BBAE339B88698FBB2A00254CB3E9D4203A1FFEC2F965 │ │ │ │ │ +2A5A803C827D84A3A8BFA2DEDE2CD5DD470D85B1F7D7EC20E83A863082F26CAA │ │ │ │ │ +990238541898F45D7B19E338D197458DF0FB32B71A27A812EBA5C8128FED95A0 │ │ │ │ │ +81B97D30784B5760567E9525A5067059D7EFBA2E5522EBF42C8F52DB8F79CB75 │ │ │ │ │ +74B79B022E15C09841D2BF696D708AB84AC1D2BB5ECFC88DABF184598F913420 │ │ │ │ │ +18965C8CC12079C24C6494DF2036E91557409855A38AE79D45B9FE6A0CBE512E │ │ │ │ │ +F81CC10A28EE9F23FA8AEB1FC0D37054AE704FCD33176FB41C3D3414FEE5A955 │ │ │ │ │ +774E771350217627BEC93F04C8624D194B4E5B4CE60D34848D30729AE676C70C │ │ │ │ │ +EBFCF90FC2D6DE25CCE70B359514833102FC30F8573BE21F900299D0BD679A5C │ │ │ │ │ +047365BFFDEB0C96F26C19761B9AA97E2F1FCB10904B806A9467A689CDFDFB9F │ │ │ │ │ +49C574F4E0A72A2F0680D0FA9488889AAB07075BEDD23892F30CC973A7A8D218 │ │ │ │ │ +FBFA576EA1A588184CA3051A709C0376F58D75440D43A1842CD7341CAD829752 │ │ │ │ │ +D727E6C65A49AD5C62EEAB7B3268E4857FCC9192A905AD1ADD387E487684FB7C │ │ │ │ │ +9F44ECC9D71B013052DC4C076DCD081ECC829BE3E8A287B36C6A42499D1661B7 │ │ │ │ │ +7DEE322B8A8F51CE168DBD8C02DB35C71AB78629AA9B5286705C46394020432C │ │ │ │ │ +F5C209BBED75A4018EEC62A3694E441357197DE8363C75AFFA5B9F402F7BB3AE │ │ │ │ │ +8DF1196DB72283BB277DB068B27AF7D954B54CF5505E802ABE802007D3CE5AFF │ │ │ │ │ +75D1EF6A04BB1BEB31664E2DA45F44FF798307814B3B2F67AE3079F627FA055B │ │ │ │ │ +DBFFBA1C4E5C716BDBC721C3E14AFF0FB60E6226603DA37D8D9207A315D684FC │ │ │ │ │ +726B18DC9D4D9FA0103DC4F270D37A9E8F3E0CEEBE02C06EE2BF2D615598B2DC │ │ │ │ │ +D9206722E02C5BD29E46D17A4DF4CC230563AEEB37E088060618009FE22279B9 │ │ │ │ │ +DA09E7078DCA24E729E447BF7434F472674F663C9F9EA36AF2E39BEDECA15880 │ │ │ │ │ +5CF5E91DAAC335FA61F270D942FD91E12E4B713F53A6433490600652D7070B45 │ │ │ │ │ +51D3CE550858CD8B6D9424BEE1CF83F061A9B2C81D87F2926B1274953A11CDD6 │ │ │ │ │ +69AC4C73380B28AF73019FF2A2AAD5082BC75284F93588739241BDCB7907FC34 │ │ │ │ │ +4161A50B8F78D155FDFEF6266CD3D4A72C5961AE5962EE1F7EFE0484E926076B │ │ │ │ │ +51256AA8269B2481A519D815C339544C052D88E2A282B14E6A1E09570CA1116C │ │ │ │ │ +C2C5FE342C7B51F5902410C27108F2C144704CA8463C0E1DB3262232117237E7 │ │ │ │ │ +A8885AA35F080DE0C1CAF5C511ED5CDC01B3F85AACFA7A54B4E5B010E9785FEF │ │ │ │ │ +A01F4D8B2970FD9EAF9C65A68A08A278211C26F81D7899B164125987114F7A45 │ │ │ │ │ +3432372AA840C4E22ADC5320ACE0C0534F6A3CC7E1CF │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ @@ -4254,22 +4234,22 @@ │ │ │ │ │ 83.022 /CMR10 rf /Fd 138[53 37 38 39 2[48 53 4[27 4[53 │ │ │ │ │ 42 53 46 13[53 2[65 72 2[57 2[36 3[63 3[72 13[48 1[48 │ │ │ │ │ 49[{}20 83.022 /CMBX10 rf /Fe 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 /Ff 205[30 30 49[{}2 49.8132 /CMR6 rf /Fg 205[35 │ │ │ │ │ -35 49[{}2 66.4176 /CMR8 rf /Fh 133[43 51 2[51 54 38 38 │ │ │ │ │ -38 1[54 49 54 1[27 2[27 54 49 30 43 54 43 1[49 13[54 │ │ │ │ │ -72 1[66 2[89 5[77 3[70 69 73 9[49 2[49 1[49 49 49 3[27 │ │ │ │ │ -44[{}33 99.6264 /CMR12 rf /Fi 172[90 2[110 121 2[97 6[106 │ │ │ │ │ -69[{}5 143.462 /CMBX12 rf /Fj 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 │ │ │ │ │ +35 49[{}2 66.4176 /CMR8 rf /Fh 133[43 3[51 54 38 38 38 │ │ │ │ │ +1[54 49 54 1[27 2[27 54 49 30 43 54 43 1[49 13[54 72 │ │ │ │ │ +1[66 5[50 2[77 3[70 69 73 11[49 2[49 1[49 3[27 44[{}30 │ │ │ │ │ +99.6264 /CMR12 rf /Fi 172[90 2[110 121 2[97 6[106 69[{}5 │ │ │ │ │ +143.462 /CMBX12 rf /Fj 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 │ │ │ │ │ TeXDict begin │ │ │ │ │ %%BeginPaperSize: Letter │ │ │ │ │ /setpagedevice where │ │ │ │ │ { pop << /PageSize [612 792] >> setpagedevice } │ │ │ │ │ @@ -4281,15 +4261,15 @@ │ │ │ │ │ %%Page: 1 1 │ │ │ │ │ TeXDict begin 1 0 bop 1103 1880 a Fj(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 Fi(SPOOLES)g Fj(2.2)1052 │ │ │ │ │ 2635 y Fh(Clev)m(e)35 b(Ashcraft)699 2751 y(Bo)s(eing)e(Shared)g │ │ │ │ │ (Services)i(Group)1995 2715 y Fg(1)2483 2635 y Fh(P)m(eter)f(Sc)m │ │ │ │ │ (hartz)2342 2751 y(CSAR)f(Corp)s(oration)3162 2715 y │ │ │ │ │ -Fg(2)1664 3012 y Fh(Ma)m(y)h(17,)e(2024)104 4919 y Ff(1)138 │ │ │ │ │ +Fg(2)1657 3012 y Fh(June)g(20,)f(2025)104 4919 y Ff(1)138 │ │ │ │ │ 4951 y Fe(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 Ff(2)138 5224 y Fe(28035)32 │ │ │ │ │ ├── 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 │ │ │ │ │ │ - May 17, 2024 │ │ │ │ │ │ + June 20, 2025 │ │ │ │ │ │ 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 │ │ │ ├── ./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 2024.05.17:2218 │ │ │ │ │ +%DVIPSSource: TeX output 2025.06.20:0449 │ │ │ │ │ %%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 │ │ │ │ │ @@ -1513,22 +1513,21 @@ │ │ │ │ │ /UnderlinePosition -100 def │ │ │ │ │ /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 49 /one put │ │ │ │ │ dup 50 /two put │ │ │ │ │ -dup 52 /four put │ │ │ │ │ -dup 55 /seven put │ │ │ │ │ +dup 53 /five put │ │ │ │ │ dup 58 /colon put │ │ │ │ │ -dup 77 /M put │ │ │ │ │ -dup 97 /a put │ │ │ │ │ -dup 121 /y put │ │ │ │ │ +dup 74 /J put │ │ │ │ │ +dup 101 /e put │ │ │ │ │ +dup 110 /n put │ │ │ │ │ +dup 117 /u put │ │ │ │ │ readonly def │ │ │ │ │ currentdict end │ │ │ │ │ currentfile eexec │ │ │ │ │ D9D66F633B846AB284BCF8B0411B772DE5CE32340DC6F28AF40857E4451976E7 │ │ │ │ │ 5182433CF9F333A38BD841C0D4E68BF9E012EB32A8FFB76B5816306B5EDF7C99 │ │ │ │ │ 8B3A16D9B4BC056662E32C7CD0123DFAEB734C7532E64BBFBF5A60336E646716 │ │ │ │ │ EFB852C877F440D329172C71F1E5D59CE9473C26B8AEF7AD68EF0727B6EC2E0C │ │ │ │ │ @@ -1709,72 +1708,64 @@ │ │ │ │ │ 7CA1534C4D5B05FC33F83790ECFD7641DF3FB94289E2A1F6E7D29AB1228A867A │ │ │ │ │ 6E1EF0E9C6F899B491DC18401C2C0A05FFFED46A72C245F7529B8EA55A038082 │ │ │ │ │ 8512307217D2A233C37004085BA3AEE379269F9FA7D0ADB4B19A95CC2AFE686E │ │ │ │ │ 55D88E47257C1FE6F235FEA295910569FE6DD5995512562359CC821E85A6C7A5 │ │ │ │ │ 79B470A9E340A6985189FF8B6AF914A6B0ECF93F47903221F95DE894A8F05B05 │ │ │ │ │ B7D99CD533EC5F931B18E6B39BECF67FA2D6DD1AEC76772B068BE06335A94C05 │ │ │ │ │ 7A4DDEE77B66101DA855C17AC312600370B34E31F5EC3A01300A8EB60B4C9767 │ │ │ │ │ -1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004B9BA1CC │ │ │ │ │ -580D3C6BDA4DC1B80B4365F1C80512453FC5316EC2D928FB731C3D6403E3C18B │ │ │ │ │ -E8424D644DF5E9A2134229C5C91CA68DB8E85BA2BB40F538F585DA6FA4037718 │ │ │ │ │ -B8053EBBA1E765346BCD5BDAA6C38115D31611D8A87A2238C145F2DA2F92E4DF │ │ │ │ │ -3987BD9C4D2A3D460E8941A68B125BCD9EE4F9FD262C4C8A71F47A2C81975635 │ │ │ │ │ -F1B981C274C53FA2ACCDE4C9D0A7C62D6C1EFF91CFC6712CA6A9F333C9564FCB │ │ │ │ │ -2A70F0AD715A79B10A08AB069E2A3C93BC0AED19D0CA10134B8DDDE8AF548DB2 │ │ │ │ │ -3A4AAA9C29682CF135BB767DAA16169A127EB50A7EECEB6480CF56A7D0F8AC56 │ │ │ │ │ -4A5090B3D75A790372886AF568D94C8165975A05BFBFDF1FFBA45F70700BB9E0 │ │ │ │ │ -57F3249EF9E9C8AD9CBCF6E4FD592DC4CDD2CC7C0BC3130C1059096C657BE453 │ │ │ │ │ -A2CBACE93420210E27AF56CA229BD6D982FB68B3FDC6D44478B922C4231C47EE │ │ │ │ │ -E500232F6C11D92DEB955F66DF52B92B22E7352790CC2DCBAC53965D57AC2920 │ │ │ │ │ -68B7D520DE25047146EFEB06B9AD4E2A94243C7E5239F0BC2FC312B16051D52C │ │ │ │ │ -0B92C217B6B42997321AE4F8BB066754B7AA3F15069EF59224E8A442CE471AA7 │ │ │ │ │ -E8049A3DD9EDA09CCEE4998998661CF7DB35E952F6C65DAEB3013951C59F3E09 │ │ │ │ │ -157F313B0237876E1C0190F0473819570B8C0205AADF05D787CC00979CFB327A │ │ │ │ │ -289382B22DDA6F12804ED0ED5B179E36A995A2A59E1B66E75130DBE9109C813B │ │ │ │ │ -94403E0DEA8314A1E9DB474D7FA83C0BAFD08033E6A6215844C1D26BE15F1251 │ │ │ │ │ -A1605E8DF9A9C601ED37379530BC1C82BE5463C6C711C5652BFD6262485AA9CA │ │ │ │ │ -B8C4A117593001D08D980041E2A83C190DCE8E6CD3D334E5CC19FC05DB30F7F7 │ │ │ │ │ -24A305C4DBB31F0651392B99D44B4302333BDF7E326FD256DD75D309C6E73F85 │ │ │ │ │ -FA71B35FD1F9BEFF4C7A1076362EEB0A85492933B6006086A7B8C1928CF2D1EE │ │ │ │ │ -FD4344409257BB802C117E739960821CD3C88BFBA5669FF16F610AD638AF3677 │ │ │ │ │ -8674C985E6767253ED5769F71BEA5E9BB02A751F9E62EE2B18AC19D975FDEAE9 │ │ │ │ │ -8B8822367FF177A7E850766DE99ED3366D46464612926430012212A90F8E85F4 │ │ │ │ │ -4760B40D5B86B90819EE410382C23E86DCAF4F0FF5DFEB2C285965F4DCF2FB2B │ │ │ │ │ -457C0A0427A8D4ADA514E9DACD0F9367E1DA225DB21DA4DDAE33F2B529686D92 │ │ │ │ │ -AC085B345565F9DFFA012FD494DBB2E0B44A0787B2B72DC8D25399DAAE8864B7 │ │ │ │ │ -E84AA99DAFCEAF18F8B41882720316450F1B1CA48B418C9736E5CE4AFF996111 │ │ │ │ │ -5F7FE80958B6A3498508E9693CB134402D92E30D4C2939070D4647E13682290E │ │ │ │ │ -1D0820A3FCA7147157D09D1A40771F214EAE7DD743EA26839E535CA186C05CB8 │ │ │ │ │ -4874988AA1104D85AF0220FE7224344FF624E794BD2454E1C0AC971522FBECBA │ │ │ │ │ -B2497F25CD621B77EC5160973EF5ECC39C183DC051B0DFCB090194A2525BD96E │ │ │ │ │ -28593FDA80D8D259F039416D5F9AF0AD3C9A105B49DAF6E681921E369B7666C6 │ │ │ │ │ -2B73DB37447B00AE96317C2F1C44FB6E6EFD740BAB20FA03A8CE018EC8415582 │ │ │ │ │ -FB06E88A2971E3A480FB1EB4FE93CC7E5179721CAABEE88742B13CF0405F49F4 │ │ │ │ │ -945E587668C821D8C06D6847B6DF84CAFFCD4628670D551FC5F7236875BE1207 │ │ │ │ │ -634BA7F70A19B658FAE7D86F6D00ED28FBF29CC585DEE279325EEF8B0CCB6149 │ │ │ │ │ -E46E638C73D75148F18A636DBC2DD96ED34F68A5A09A3700B1EA34B2D142807C │ │ │ │ │ -F8709D81180783548EAE6F457BF968602076A1069163E3C15BBCEF659C6CF2E6 │ │ │ │ │ -0BB01BDC8E503802CC7969A5B8477E9788C5249B23B19669F5075E089738E49A │ │ │ │ │ -8671D7C1B1B47652F3D78BF2FF74EDB44BA5B092E8D5B85001E97F69D54AEEFC │ │ │ │ │ -88FC3CA1B0D5BAC39263B371005BCFA19AD197A31CC34D0BD55C2CA18C60C485 │ │ │ │ │ -5993F736EF1DD2C5D2B4D50B3D498861B4DF5E7AFF614BBCA4C2E6BECC0DCEF5 │ │ │ │ │ -95F0D686188014C530D8E37650CDCAE721B4AFB0F178BC744BDDDED45DAB7FEB │ │ │ │ │ -A10B975E26099E3DC61116D6BF554574F948895B88EEFE03DCC5351190836AD4 │ │ │ │ │ -EBC1AC55C6D099A8E7B0A372D290C481F44FA464B9C11A0BC991CB045E0AAAC4 │ │ │ │ │ -5C73CA43A4F17D1ADDD33D1B917FF95BFF411C8409F41553B1BC97DE47E3A1F4 │ │ │ │ │ -A5C1D1B7B1BF7E2507AC53956C141411F4F657E37981996DD7BB7ADB2CB6AE01 │ │ │ │ │ -73D0876B8F896F626D5022FE53BA34D5668BD698BE8D5CCAD083CBCEF440BE6A │ │ │ │ │ -8090EB1CDEE5F99C8988650BD4E539B357C31C597D8A9104A9D5967D4E906CAD │ │ │ │ │ -2A65575A884B1C5F6CC509E742FA9DDD66494F219178161AF72C50848E226A95 │ │ │ │ │ -A8C247FF9FF0BABD073021271B5C0692F9BE220071DAB09E5A026629371EE3C4 │ │ │ │ │ -A6E4FA94625D87A5B66EF077ED54C72B1052AEAA9637B30C76EF8EB04AD5F476 │ │ │ │ │ -D15F1C93C0BC6E0F67B366097BBED03FE82C040F9EF02866159B46854E11D44F │ │ │ │ │ -54AE6748A7E61B993A4EECD3B8BE3B5897A66BBCDFE24F65BC2AD5AB49048CF1 │ │ │ │ │ -647203823F84DF5CB483096F9D96AEE3A2855E479B72A14A67C633CE99C101CF │ │ │ │ │ -EFAE939BF9B02E710D │ │ │ │ │ +1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004ACD1870 │ │ │ │ │ +A5EA947858F5795870BFE1343AD803FB854BF8F5A4E794E8EC57BE41DB5B8734 │ │ │ │ │ +13E47950F29A81EA0C81EA798863883D7F41F78325CA190CBBFFE822AE494550 │ │ │ │ │ +4BE83703071FC9512D128927AF3F63CEF8F86ABE1E15D7B4DDD39576E7DFF45E │ │ │ │ │ +3CB4115AAB1830DE8647B915DB4BEBEB5235C281E098B899BAB951D8D5798F01 │ │ │ │ │ +7F7C47336D31438E5126738AFEAB29E9A7CBE06DE4DD604477B542D2620DFD58 │ │ │ │ │ +28FE34238572F23C5A8EB7ACEE1E154DA13FC1A5AA67A3BA8C5CDFB2B80312C9 │ │ │ │ │ +BC9FAE56D08DDFA9498E6EF0D0F6BD18B3923E0B670B0740528BC843610736CB │ │ │ │ │ +80228C105C2F72C3C22D610C3D8C268DEEA2AEEE3221E198E79FE2966487360C │ │ │ │ │ +84AE08AC326F48B21447652121B1EB68AF856055EEA65B6B625BF622CBFC2D1C │ │ │ │ │ +EF943CC4CAF2C715782C9EF9A9BA4689BFC6B6A82F8D55795BE8111E2C7DE520 │ │ │ │ │ +367362304B6A48186C842033E715A46265A352472F4F7313248EBCD26BEA97E7 │ │ │ │ │ +B814A61D4B7ADCB5C5F21AA34E0C1269E8426DBFB511DE6E26B960456C8F8520 │ │ │ │ │ +5F0DD382289A62AF0B935EDB5B2394538C5F0EE72962D2F98F3C38CD7C027B9F │ │ │ │ │ +E230E67E40FEFBDED06B3423C9DFD669E6B5BC913E0FF75786A64A6C11D4FE89 │ │ │ │ │ +1B918DC0E953C52CFD153063CD0D2A78B43F8712243845E6F2CBA1DB610F403D │ │ │ │ │ +A98D06D95FF44C7AC029092B666A8B0DCEA95B34F5ACC10E8611BADE6A24469C │ │ │ │ │ +0C01D95BFB445FA22CD38D033E4D24E006BB9D54EE41EF7AD5AC9C299721F61A │ │ │ │ │ +F01B6EDCDF428BD9195A13C5B1027358F8A203F828A1DD9622243B2D76C6F1BA │ │ │ │ │ +9F2D7E9D4879FC668ABC750CD25415DC6CCF2257C28F78D3F9BE499CC0FF2F80 │ │ │ │ │ +2C2CD1DEFABD6668FCA76E1D629A344333E33DA24B86D2E9F8F5EE1C29974640 │ │ │ │ │ +C3E78E999BAB313400041DADDDFDBFFCC419F129A84F4D412B79E8BE4511CA00 │ │ │ │ │ +F92A4F3CDD2E51345D3965C104F06B6503445DC20224CB7606A9D7D5F9EE45E6 │ │ │ │ │ +1B2963DA96AA2AB1BA5BE29656E666E4D0E122DE58EEA68E04ED76438DA03E65 │ │ │ │ │ +B80055A86B7B2A26BAE6BBB8835E17F9696E9B3CD34571BA75C76D4D2CCC48F1 │ │ │ │ │ +7534C1EF9127E374D65D05B8072E08D6C72A0B4A35EA0DD717743C66D105CCD8 │ │ │ │ │ +7355F13E9C38C1A4351624E689ED7909100942FA0474842EE44DEC3279E1A1CD │ │ │ │ │ +8064666EB845CA7C3E906B67C0BF96A28D514DB2E4A1E4AF287350B03762A2CF │ │ │ │ │ +13B18AC3F5D2F3B74A1D50267C03EFB74B888E1D24ABEEA4A885F4D0BF14C0D8 │ │ │ │ │ +289AC79D6D98E2A2C831672FB1F3457564CD161ADC3AF610D88201AB5B0C10CB │ │ │ │ │ +5ECCC2D5C4AF39C8CB3044BF9EC791BA45D29C2B51EA0483D19822C264CE6FA3 │ │ │ │ │ +5C97F2DF5A78CB93528E99B9ED7CB121C83130C129B849B52A36EBD88AF19DD3 │ │ │ │ │ +C5CABE831027388EF86BD5CBD90AAAC089775938A321C44D4DDA67A51312D8AB │ │ │ │ │ +C509DDBE7044A107AB2BE9C4C9556F85C529B174A7778B489BF28EC07A834542 │ │ │ │ │ +8B31F2925C21FB2096877711F998763D5A8495002B8E080AF8DBB1B3106EDDBA │ │ │ │ │ +35121D52E0846A7AF3ABEDF87BDE4FA665673A9B80CA538B98F873947AA17EF4 │ │ │ │ │ +9BB182917E9D79BC7EC681E93710D6A1D6B0E4A7FA9452FC1C431808174F3AB7 │ │ │ │ │ +F3914FBC86CB34E8583457243C3C7BE4BC166C7397689BC6FFB82EA2967E88EE │ │ │ │ │ +464F96EDA144DE2B64401B8E577ABCA2D826FE0B92E21FFAE3E81EBB6B6EB36E │ │ │ │ │ +9B1A8FE3884CA398C03135FD49D51724FC1268E9482E41FAEA2FC6C809006B8F │ │ │ │ │ +5D4F9E038450AD3A6041C16FD1C7E5FC80C0E033CE57E64863E014531D94DF1E │ │ │ │ │ +31D7D038AFCB60715AA73C1E96F113A24C5AF35BBEB61C4D079ED034ED83AA4A │ │ │ │ │ +E12448E618330463304788BCF40561CD63167B3BF144F408E2B89E60B8BA13EF │ │ │ │ │ +3B57D286FD23D4FA8BAEFF98DC1188B1982956CC1DCAEFC7D949B7B4E3BE8F8A │ │ │ │ │ +BFE2C9D938DD13EFEE7123576608D9396F260907DA98AE2D3DD5822306CBC8A6 │ │ │ │ │ +B083C697DDA3C62EE7879436A9FD8EE0034B105105B3F122F893EA2126EBE8A9 │ │ │ │ │ +5CBF2BD248DD9FBEF0040C25797BD13B69A8C9F0D4E4F935C61ED30487CCDB1A │ │ │ │ │ +0339006E78EE1755929D2412776EC7DB1F666DBDD28EA8AC7397F809C7F38A41 │ │ │ │ │ +5B3BF6C75F4F35C90141EB08377AF452CF840FEA938805F9D14E02DC29215B4E │ │ │ │ │ +F1EB │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ @@ -2986,16 +2977,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 23[45 19[83 18[25 2[45 2[45 1[45 │ │ │ │ │ -45 45 3[25 44[{}10 90.9091 /CMSL10 rf │ │ │ │ │ +/CMTI10 rf /Fd 138[51 6[51 8[40 26[47 15[25 4[45 2[45 │ │ │ │ │ +1[45 3[25 44[{}9 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 │ │ │ │ │ @@ -3103,17 +3094,17 @@ │ │ │ │ │ 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 1203 4 v │ │ │ │ │ -1385 w Fg(Lock)29 b Fd(:)41 b Fc(DRAFT)30 b Fd(Ma)m(y)h(17,)h(2024)p │ │ │ │ │ -2698 100 V 0 399 a Ff(1.2)135 b(Protot)l(yp)t(es)46 b(and)f │ │ │ │ │ +TeXDict begin 2 1 bop 0 100 a Fh(2)p 136 100 1196 4 v │ │ │ │ │ +1378 w Fg(Lock)29 b Fd(:)41 b Fc(DRAFT)30 b Fd(June)f(20,)j(2025)p │ │ │ │ │ +2704 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 │ │ │ │ │ @@ -3171,17 +3162,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 1203 4 v 1384 100 a Fg(Lock)29 │ │ │ │ │ -b Fd(:)41 b Fc(DRAFT)121 b Fd(Ma)m(y)32 b(17,)f(2024)p │ │ │ │ │ -2650 100 V 1203 w Fh(3)111 399 y(2.)46 b Fg(void)h(Lock_unlock)e(\()i │ │ │ │ │ +TeXDict begin 3 2 bop 91 100 1196 4 v 1377 100 a Fg(Lock)30 │ │ │ │ │ +b Fd(:)40 b Fc(DRAFT)121 b Fd(June)30 b(20,)h(2025)p │ │ │ │ │ +2657 100 V 1196 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 May 17, 2024 │ │ │ │ │ │ + 2 Lock : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 3 │ │ │ │ │ │ + Lock : DRAFT June 20, 2025 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 2024.05.17:2218 │ │ │ │ │ +%DVIPSSource: TeX output 2025.06.20:0450 │ │ │ │ │ %%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 │ │ │ │ │ @@ -1204,22 +1204,21 @@ │ │ │ │ │ /UnderlinePosition -100 def │ │ │ │ │ /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 49 /one put │ │ │ │ │ dup 50 /two put │ │ │ │ │ -dup 52 /four put │ │ │ │ │ -dup 55 /seven put │ │ │ │ │ +dup 53 /five put │ │ │ │ │ dup 58 /colon put │ │ │ │ │ -dup 77 /M put │ │ │ │ │ -dup 97 /a put │ │ │ │ │ -dup 121 /y put │ │ │ │ │ +dup 74 /J put │ │ │ │ │ +dup 101 /e put │ │ │ │ │ +dup 110 /n put │ │ │ │ │ +dup 117 /u put │ │ │ │ │ readonly def │ │ │ │ │ currentdict end │ │ │ │ │ currentfile eexec │ │ │ │ │ D9D66F633B846AB284BCF8B0411B772DE5CE32340DC6F28AF40857E4451976E7 │ │ │ │ │ 5182433CF9F333A38BD841C0D4E68BF9E012EB32A8FFB76B5816306B5EDF7C99 │ │ │ │ │ 8B3A16D9B4BC056662E32C7CD0123DFAEB734C7532E64BBFBF5A60336E646716 │ │ │ │ │ EFB852C877F440D329172C71F1E5D59CE9473C26B8AEF7AD68EF0727B6EC2E0C │ │ │ │ │ @@ -1400,72 +1399,64 @@ │ │ │ │ │ 7CA1534C4D5B05FC33F83790ECFD7641DF3FB94289E2A1F6E7D29AB1228A867A │ │ │ │ │ 6E1EF0E9C6F899B491DC18401C2C0A05FFFED46A72C245F7529B8EA55A038082 │ │ │ │ │ 8512307217D2A233C37004085BA3AEE379269F9FA7D0ADB4B19A95CC2AFE686E │ │ │ │ │ 55D88E47257C1FE6F235FEA295910569FE6DD5995512562359CC821E85A6C7A5 │ │ │ │ │ 79B470A9E340A6985189FF8B6AF914A6B0ECF93F47903221F95DE894A8F05B05 │ │ │ │ │ B7D99CD533EC5F931B18E6B39BECF67FA2D6DD1AEC76772B068BE06335A94C05 │ │ │ │ │ 7A4DDEE77B66101DA855C17AC312600370B34E31F5EC3A01300A8EB60B4C9767 │ │ │ │ │ -1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004B9BA1CC │ │ │ │ │ -580D3C6BDA4DC1B80B4365F1C80512453FC5316EC2D928FB731C3D6403E3C18B │ │ │ │ │ -E8424D644DF5E9A2134229C5C91CA68DB8E85BA2BB40F538F585DA6FA4037718 │ │ │ │ │ -B8053EBBA1E765346BCD5BDAA6C38115D31611D8A87A2238C145F2DA2F92E4DF │ │ │ │ │ -3987BD9C4D2A3D460E8941A68B125BCD9EE4F9FD262C4C8A71F47A2C81975635 │ │ │ │ │ -F1B981C274C53FA2ACCDE4C9D0A7C62D6C1EFF91CFC6712CA6A9F333C9564FCB │ │ │ │ │ -2A70F0AD715A79B10A08AB069E2A3C93BC0AED19D0CA10134B8DDDE8AF548DB2 │ │ │ │ │ -3A4AAA9C29682CF135BB767DAA16169A127EB50A7EECEB6480CF56A7D0F8AC56 │ │ │ │ │ -4A5090B3D75A790372886AF568D94C8165975A05BFBFDF1FFBA45F70700BB9E0 │ │ │ │ │ -57F3249EF9E9C8AD9CBCF6E4FD592DC4CDD2CC7C0BC3130C1059096C657BE453 │ │ │ │ │ -A2CBACE93420210E27AF56CA229BD6D982FB68B3FDC6D44478B922C4231C47EE │ │ │ │ │ -E500232F6C11D92DEB955F66DF52B92B22E7352790CC2DCBAC53965D57AC2920 │ │ │ │ │ -68B7D520DE25047146EFEB06B9AD4E2A94243C7E5239F0BC2FC312B16051D52C │ │ │ │ │ -0B92C217B6B42997321AE4F8BB066754B7AA3F15069EF59224E8A442CE471AA7 │ │ │ │ │ -E8049A3DD9EDA09CCEE4998998661CF7DB35E952F6C65DAEB3013951C59F3E09 │ │ │ │ │ -157F313B0237876E1C0190F0473819570B8C0205AADF05D787CC00979CFB327A │ │ │ │ │ -289382B22DDA6F12804ED0ED5B179E36A995A2A59E1B66E75130DBE9109C813B │ │ │ │ │ -94403E0DEA8314A1E9DB474D7FA83C0BAFD08033E6A6215844C1D26BE15F1251 │ │ │ │ │ -A1605E8DF9A9C601ED37379530BC1C82BE5463C6C711C5652BFD6262485AA9CA │ │ │ │ │ -B8C4A117593001D08D980041E2A83C190DCE8E6CD3D334E5CC19FC05DB30F7F7 │ │ │ │ │ -24A305C4DBB31F0651392B99D44B4302333BDF7E326FD256DD75D309C6E73F85 │ │ │ │ │ -FA71B35FD1F9BEFF4C7A1076362EEB0A85492933B6006086A7B8C1928CF2D1EE │ │ │ │ │ -FD4344409257BB802C117E739960821CD3C88BFBA5669FF16F610AD638AF3677 │ │ │ │ │ -8674C985E6767253ED5769F71BEA5E9BB02A751F9E62EE2B18AC19D975FDEAE9 │ │ │ │ │ -8B8822367FF177A7E850766DE99ED3366D46464612926430012212A90F8E85F4 │ │ │ │ │ -4760B40D5B86B90819EE410382C23E86DCAF4F0FF5DFEB2C285965F4DCF2FB2B │ │ │ │ │ -457C0A0427A8D4ADA514E9DACD0F9367E1DA225DB21DA4DDAE33F2B529686D92 │ │ │ │ │ -AC085B345565F9DFFA012FD494DBB2E0B44A0787B2B72DC8D25399DAAE8864B7 │ │ │ │ │ -E84AA99DAFCEAF18F8B41882720316450F1B1CA48B418C9736E5CE4AFF996111 │ │ │ │ │ -5F7FE80958B6A3498508E9693CB134402D92E30D4C2939070D4647E13682290E │ │ │ │ │ -1D0820A3FCA7147157D09D1A40771F214EAE7DD743EA26839E535CA186C05CB8 │ │ │ │ │ -4874988AA1104D85AF0220FE7224344FF624E794BD2454E1C0AC971522FBECBA │ │ │ │ │ -B2497F25CD621B77EC5160973EF5ECC39C183DC051B0DFCB090194A2525BD96E │ │ │ │ │ -28593FDA80D8D259F039416D5F9AF0AD3C9A105B49DAF6E681921E369B7666C6 │ │ │ │ │ -2B73DB37447B00AE96317C2F1C44FB6E6EFD740BAB20FA03A8CE018EC8415582 │ │ │ │ │ -FB06E88A2971E3A480FB1EB4FE93CC7E5179721CAABEE88742B13CF0405F49F4 │ │ │ │ │ -945E587668C821D8C06D6847B6DF84CAFFCD4628670D551FC5F7236875BE1207 │ │ │ │ │ -634BA7F70A19B658FAE7D86F6D00ED28FBF29CC585DEE279325EEF8B0CCB6149 │ │ │ │ │ -E46E638C73D75148F18A636DBC2DD96ED34F68A5A09A3700B1EA34B2D142807C │ │ │ │ │ -F8709D81180783548EAE6F457BF968602076A1069163E3C15BBCEF659C6CF2E6 │ │ │ │ │ -0BB01BDC8E503802CC7969A5B8477E9788C5249B23B19669F5075E089738E49A │ │ │ │ │ -8671D7C1B1B47652F3D78BF2FF74EDB44BA5B092E8D5B85001E97F69D54AEEFC │ │ │ │ │ -88FC3CA1B0D5BAC39263B371005BCFA19AD197A31CC34D0BD55C2CA18C60C485 │ │ │ │ │ -5993F736EF1DD2C5D2B4D50B3D498861B4DF5E7AFF614BBCA4C2E6BECC0DCEF5 │ │ │ │ │ -95F0D686188014C530D8E37650CDCAE721B4AFB0F178BC744BDDDED45DAB7FEB │ │ │ │ │ -A10B975E26099E3DC61116D6BF554574F948895B88EEFE03DCC5351190836AD4 │ │ │ │ │ -EBC1AC55C6D099A8E7B0A372D290C481F44FA464B9C11A0BC991CB045E0AAAC4 │ │ │ │ │ -5C73CA43A4F17D1ADDD33D1B917FF95BFF411C8409F41553B1BC97DE47E3A1F4 │ │ │ │ │ -A5C1D1B7B1BF7E2507AC53956C141411F4F657E37981996DD7BB7ADB2CB6AE01 │ │ │ │ │ -73D0876B8F896F626D5022FE53BA34D5668BD698BE8D5CCAD083CBCEF440BE6A │ │ │ │ │ -8090EB1CDEE5F99C8988650BD4E539B357C31C597D8A9104A9D5967D4E906CAD │ │ │ │ │ -2A65575A884B1C5F6CC509E742FA9DDD66494F219178161AF72C50848E226A95 │ │ │ │ │ -A8C247FF9FF0BABD073021271B5C0692F9BE220071DAB09E5A026629371EE3C4 │ │ │ │ │ -A6E4FA94625D87A5B66EF077ED54C72B1052AEAA9637B30C76EF8EB04AD5F476 │ │ │ │ │ -D15F1C93C0BC6E0F67B366097BBED03FE82C040F9EF02866159B46854E11D44F │ │ │ │ │ -54AE6748A7E61B993A4EECD3B8BE3B5897A66BBCDFE24F65BC2AD5AB49048CF1 │ │ │ │ │ -647203823F84DF5CB483096F9D96AEE3A2855E479B72A14A67C633CE99C101CF │ │ │ │ │ -EFAE939BF9B02E710D │ │ │ │ │ +1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004ACD1870 │ │ │ │ │ +A5EA947858F5795870BFE1343AD803FB854BF8F5A4E794E8EC57BE41DB5B8734 │ │ │ │ │ +13E47950F29A81EA0C81EA798863883D7F41F78325CA190CBBFFE822AE494550 │ │ │ │ │ +4BE83703071FC9512D128927AF3F63CEF8F86ABE1E15D7B4DDD39576E7DFF45E │ │ │ │ │ +3CB4115AAB1830DE8647B915DB4BEBEB5235C281E098B899BAB951D8D5798F01 │ │ │ │ │ +7F7C47336D31438E5126738AFEAB29E9A7CBE06DE4DD604477B542D2620DFD58 │ │ │ │ │ +28FE34238572F23C5A8EB7ACEE1E154DA13FC1A5AA67A3BA8C5CDFB2B80312C9 │ │ │ │ │ +BC9FAE56D08DDFA9498E6EF0D0F6BD18B3923E0B670B0740528BC843610736CB │ │ │ │ │ +80228C105C2F72C3C22D610C3D8C268DEEA2AEEE3221E198E79FE2966487360C │ │ │ │ │ +84AE08AC326F48B21447652121B1EB68AF856055EEA65B6B625BF622CBFC2D1C │ │ │ │ │ +EF943CC4CAF2C715782C9EF9A9BA4689BFC6B6A82F8D55795BE8111E2C7DE520 │ │ │ │ │ +367362304B6A48186C842033E715A46265A352472F4F7313248EBCD26BEA97E7 │ │ │ │ │ +B814A61D4B7ADCB5C5F21AA34E0C1269E8426DBFB511DE6E26B960456C8F8520 │ │ │ │ │ +5F0DD382289A62AF0B935EDB5B2394538C5F0EE72962D2F98F3C38CD7C027B9F │ │ │ │ │ +E230E67E40FEFBDED06B3423C9DFD669E6B5BC913E0FF75786A64A6C11D4FE89 │ │ │ │ │ +1B918DC0E953C52CFD153063CD0D2A78B43F8712243845E6F2CBA1DB610F403D │ │ │ │ │ +A98D06D95FF44C7AC029092B666A8B0DCEA95B34F5ACC10E8611BADE6A24469C │ │ │ │ │ +0C01D95BFB445FA22CD38D033E4D24E006BB9D54EE41EF7AD5AC9C299721F61A │ │ │ │ │ +F01B6EDCDF428BD9195A13C5B1027358F8A203F828A1DD9622243B2D76C6F1BA │ │ │ │ │ +9F2D7E9D4879FC668ABC750CD25415DC6CCF2257C28F78D3F9BE499CC0FF2F80 │ │ │ │ │ +2C2CD1DEFABD6668FCA76E1D629A344333E33DA24B86D2E9F8F5EE1C29974640 │ │ │ │ │ +C3E78E999BAB313400041DADDDFDBFFCC419F129A84F4D412B79E8BE4511CA00 │ │ │ │ │ +F92A4F3CDD2E51345D3965C104F06B6503445DC20224CB7606A9D7D5F9EE45E6 │ │ │ │ │ +1B2963DA96AA2AB1BA5BE29656E666E4D0E122DE58EEA68E04ED76438DA03E65 │ │ │ │ │ +B80055A86B7B2A26BAE6BBB8835E17F9696E9B3CD34571BA75C76D4D2CCC48F1 │ │ │ │ │ +7534C1EF9127E374D65D05B8072E08D6C72A0B4A35EA0DD717743C66D105CCD8 │ │ │ │ │ +7355F13E9C38C1A4351624E689ED7909100942FA0474842EE44DEC3279E1A1CD │ │ │ │ │ +8064666EB845CA7C3E906B67C0BF96A28D514DB2E4A1E4AF287350B03762A2CF │ │ │ │ │ +13B18AC3F5D2F3B74A1D50267C03EFB74B888E1D24ABEEA4A885F4D0BF14C0D8 │ │ │ │ │ +289AC79D6D98E2A2C831672FB1F3457564CD161ADC3AF610D88201AB5B0C10CB │ │ │ │ │ +5ECCC2D5C4AF39C8CB3044BF9EC791BA45D29C2B51EA0483D19822C264CE6FA3 │ │ │ │ │ +5C97F2DF5A78CB93528E99B9ED7CB121C83130C129B849B52A36EBD88AF19DD3 │ │ │ │ │ +C5CABE831027388EF86BD5CBD90AAAC089775938A321C44D4DDA67A51312D8AB │ │ │ │ │ +C509DDBE7044A107AB2BE9C4C9556F85C529B174A7778B489BF28EC07A834542 │ │ │ │ │ +8B31F2925C21FB2096877711F998763D5A8495002B8E080AF8DBB1B3106EDDBA │ │ │ │ │ +35121D52E0846A7AF3ABEDF87BDE4FA665673A9B80CA538B98F873947AA17EF4 │ │ │ │ │ +9BB182917E9D79BC7EC681E93710D6A1D6B0E4A7FA9452FC1C431808174F3AB7 │ │ │ │ │ +F3914FBC86CB34E8583457243C3C7BE4BC166C7397689BC6FFB82EA2967E88EE │ │ │ │ │ +464F96EDA144DE2B64401B8E577ABCA2D826FE0B92E21FFAE3E81EBB6B6EB36E │ │ │ │ │ +9B1A8FE3884CA398C03135FD49D51724FC1268E9482E41FAEA2FC6C809006B8F │ │ │ │ │ +5D4F9E038450AD3A6041C16FD1C7E5FC80C0E033CE57E64863E014531D94DF1E │ │ │ │ │ +31D7D038AFCB60715AA73C1E96F113A24C5AF35BBEB61C4D079ED034ED83AA4A │ │ │ │ │ +E12448E618330463304788BCF40561CD63167B3BF144F408E2B89E60B8BA13EF │ │ │ │ │ +3B57D286FD23D4FA8BAEFF98DC1188B1982956CC1DCAEFC7D949B7B4E3BE8F8A │ │ │ │ │ +BFE2C9D938DD13EFEE7123576608D9396F260907DA98AE2D3DD5822306CBC8A6 │ │ │ │ │ +B083C697DDA3C62EE7879436A9FD8EE0034B105105B3F122F893EA2126EBE8A9 │ │ │ │ │ +5CBF2BD248DD9FBEF0040C25797BD13B69A8C9F0D4E4F935C61ED30487CCDB1A │ │ │ │ │ +0339006E78EE1755929D2412776EC7DB1F666DBDD28EA8AC7397F809C7F38A41 │ │ │ │ │ +5B3BF6C75F4F35C90141EB08377AF452CF840FEA938805F9D14E02DC29215B4E │ │ │ │ │ +F1EB │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ @@ -4881,17 +4872,17 @@ │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 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 23[42 │ │ │ │ │ -19[76 18[23 2[42 2[42 1[42 42 42 3[23 44[{}10 83.022 │ │ │ │ │ -/CMSL10 rf /Fe 132[48 59[45 63[{}2 83.022 /CMBX10 rf │ │ │ │ │ +2[62 3[62 73[{}3 119.552 /CMTT12 rf /Fd 138[46 6[46 8[37 │ │ │ │ │ +26[43 15[23 4[42 2[42 1[42 3[23 44[{}9 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 │ │ │ │ │ /tieaccentlowercase.new/tieaccentcapital.new/.notdef/afii61664.asc/uni2422 3 │ │ │ │ │ {/.notdef}repeat/dollar/.notdef/.notdef/quotesingle/.notdef/.notdef │ │ │ │ │ @@ -5039,17 +5030,17 @@ │ │ │ │ │ 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 1294 4 v │ │ │ │ │ -1459 w Fl(MPI)27 b Fd(:)g Fm(DRAFT)h Fd(Ma)n(y)e(17,)h(2024)p │ │ │ │ │ -2606 100 V 301 390 a Fe({)41 b Fn(2)27 b(\()p Fl(SPOOLES)p │ │ │ │ │ +TeXDict begin 2 1 bop 0 100 a Fn(2)p 125 100 1288 4 v │ │ │ │ │ +1453 w Fl(MPI)26 b Fd(:)i Fm(DRAFT)f Fd(June)h(20,)f(2025)p │ │ │ │ │ +2613 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 │ │ │ │ │ @@ -5129,17 +5120,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 1294 4 v 1460 100 a Fl(MPI)26 │ │ │ │ │ -b Fd(:)i Fm(DRAFT)110 b Fd(Ma)n(y)27 b(17,)g(2024)p 2567 │ │ │ │ │ -100 V 1294 w Fn(3)556 377 y Fl(stats[0])97 b Fn(|)i(#)28 │ │ │ │ │ +TeXDict begin 3 2 bop 83 100 1288 4 v 1453 100 a Fl(MPI)27 │ │ │ │ │ +b Fd(:)h Fm(DRAFT)110 b Fd(June)27 b(20,)g(2025)p 2573 │ │ │ │ │ +100 V 1288 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) │ │ │ │ │ @@ -5237,17 +5228,17 @@ │ │ │ │ │ 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 1294 4 v │ │ │ │ │ -1459 w Fl(MPI)27 b Fd(:)g Fm(DRAFT)h Fd(Ma)n(y)e(17,)h(2024)p │ │ │ │ │ -2606 100 V 208 390 a Fn(Note,)g(the)h(v)-5 b(alues)27 │ │ │ │ │ +TeXDict begin 4 3 bop 0 100 a Fn(4)p 125 100 1288 4 v │ │ │ │ │ +1453 w Fl(MPI)26 b Fd(:)i Fm(DRAFT)f Fd(June)h(20,)f(2025)p │ │ │ │ │ +2613 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 │ │ │ │ │ @@ -5335,17 +5326,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 1294 4 v 1460 100 a Fl(MPI)26 │ │ │ │ │ -b Fd(:)i Fm(DRAFT)110 b Fd(Ma)n(y)27 b(17,)g(2024)p 2567 │ │ │ │ │ -100 V 1294 w Fn(5)0 390 y Fj(1.2.2)112 b(Gather)38 b(and)h(scatter)e │ │ │ │ │ +TeXDict begin 5 4 bop 83 100 1288 4 v 1453 100 a Fl(MPI)27 │ │ │ │ │ +b Fd(:)h Fm(DRAFT)110 b Fd(June)27 b(20,)g(2025)p 2573 │ │ │ │ │ +100 V 1288 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 │ │ │ │ │ @@ -5427,17 +5418,17 @@ │ │ │ │ │ 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 1294 4 v │ │ │ │ │ -1459 w Fl(MPI)27 b Fd(:)g Fm(DRAFT)h Fd(Ma)n(y)e(17,)h(2024)p │ │ │ │ │ -2606 100 V 208 390 a Fn(These)19 b(metho)r(ds)h(are)e(used)i(in)g │ │ │ │ │ +TeXDict begin 6 5 bop 0 100 a Fn(6)p 125 100 1288 4 v │ │ │ │ │ +1453 w Fl(MPI)26 b Fd(:)i Fm(DRAFT)f Fd(June)h(20,)f(2025)p │ │ │ │ │ +2613 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 │ │ │ │ │ @@ -5525,17 +5516,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 1294 4 v 1460 100 a Fl(MPI)26 │ │ │ │ │ -b Fd(:)i Fm(DRAFT)110 b Fd(Ma)n(y)27 b(17,)g(2024)p 2567 │ │ │ │ │ -100 V 1294 w Fn(7)208 390 y(On)g(return,)g(the)h Fl(stats[])d │ │ │ │ │ +TeXDict begin 7 6 bop 83 100 1288 4 v 1453 100 a Fl(MPI)27 │ │ │ │ │ +b Fd(:)h Fm(DRAFT)110 b Fd(June)27 b(20,)g(2025)p 2573 │ │ │ │ │ +100 V 1288 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 │ │ │ │ │ @@ -5617,17 +5608,17 @@ │ │ │ │ │ 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 1294 4 v │ │ │ │ │ -1459 w Fl(MPI)27 b Fd(:)g Fm(DRAFT)h Fd(Ma)n(y)e(17,)h(2024)p │ │ │ │ │ -2606 100 V 208 390 a Fn(ob)5 b(ject,)33 b(and)g(comm)n(unicates)f(the)h │ │ │ │ │ +TeXDict begin 8 7 bop 0 100 a Fn(8)p 125 100 1288 4 v │ │ │ │ │ +1453 w Fl(MPI)26 b Fd(:)i Fm(DRAFT)f Fd(June)h(20,)f(2025)p │ │ │ │ │ +2613 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 │ │ │ │ │ @@ -5703,17 +5694,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 1294 4 v 1460 100 a Fl(MPI)26 │ │ │ │ │ -b Fd(:)i Fm(DRAFT)110 b Fd(Ma)n(y)27 b(17,)g(2024)p 2567 │ │ │ │ │ -100 V 1294 w Fn(9)0 390 y Fj(1.2.7)112 b(Matrix-matrix)39 │ │ │ │ │ +TeXDict begin 9 8 bop 83 100 1288 4 v 1453 100 a Fl(MPI)27 │ │ │ │ │ +b Fd(:)h Fm(DRAFT)110 b Fd(June)27 b(20,)g(2025)p 2573 │ │ │ │ │ +100 V 1288 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 │ │ │ │ │ @@ -5788,17 +5779,17 @@ │ │ │ │ │ (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 1273 4 │ │ │ │ │ -v 1438 w Fl(MPI)26 b Fd(:)i Fm(DRAFT)f Fd(Ma)n(y)g(17,)g(2024)p │ │ │ │ │ -2627 100 V 101 390 a Fn(3.)42 b Fl(void)f(MatMul_MPI_mmm)d(\()43 │ │ │ │ │ +TeXDict begin 10 9 bop 0 100 a Fn(10)p 166 100 1267 4 │ │ │ │ │ +v 1432 w Fl(MPI)26 b Fd(:)i Fm(DRAFT)f Fd(June)h(20,)e(2025)p │ │ │ │ │ +2633 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 │ │ │ │ │ @@ -5878,17 +5869,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 1273 4 v 1439 100 a Fl(MPI)26 │ │ │ │ │ -b Fd(:)i Fm(DRAFT)110 b Fd(Ma)n(y)27 b(17,)g(2024)p 2546 │ │ │ │ │ -100 V 1273 w Fn(11)0 390 y Fj(1.2.9)112 b(Utilit)m(y)38 │ │ │ │ │ +TeXDict begin 11 10 bop 83 100 1267 4 v 1433 100 a Fl(MPI)26 │ │ │ │ │ +b Fd(:)i Fm(DRAFT)110 b Fd(June)28 b(20,)e(2025)p 2552 │ │ │ │ │ +100 V 1267 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 │ │ │ │ │ @@ -5972,17 +5963,17 @@ │ │ │ │ │ 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 1273 │ │ │ │ │ -4 v 1438 w Fl(MPI)26 b Fd(:)i Fm(DRAFT)f Fd(Ma)n(y)g(17,)g(2024)p │ │ │ │ │ -2627 100 V 556 377 a Fl(stats[0])97 b Fn(|)i(#)28 b(of)g(messages)e │ │ │ │ │ +TeXDict begin 12 11 bop 0 100 a Fn(12)p 166 100 1267 │ │ │ │ │ +4 v 1432 w Fl(MPI)26 b Fd(:)i Fm(DRAFT)f Fd(June)h(20,)e(2025)p │ │ │ │ │ +2633 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 │ │ │ │ │ @@ -6051,17 +6042,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 1273 4 v 1439 100 a Fl(MPI)26 │ │ │ │ │ -b Fd(:)i Fm(DRAFT)110 b Fd(Ma)n(y)27 b(17,)g(2024)p 2546 │ │ │ │ │ -100 V 1273 w Fn(13)208 390 y(where)j Fl(neqns)g Fn(is)h(the)h(global)e │ │ │ │ │ +TeXDict begin 13 12 bop 83 100 1267 4 v 1433 100 a Fl(MPI)26 │ │ │ │ │ +b Fd(:)i Fm(DRAFT)110 b Fd(June)28 b(20,)e(2025)p 2552 │ │ │ │ │ +100 V 1267 w Fn(13)208 390 y(where)k 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(is)h │ │ │ │ │ @@ -6136,17 +6127,17 @@ │ │ │ │ │ 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 1273 │ │ │ │ │ -4 v 1438 w Fl(MPI)26 b Fd(:)i Fm(DRAFT)f Fd(Ma)n(y)g(17,)g(2024)p │ │ │ │ │ -2627 100 V 307 390 a Ff(\210)42 b Fn(The)23 b Fl(msglvl)e │ │ │ │ │ +TeXDict begin 14 13 bop 0 100 a Fn(14)p 166 100 1267 │ │ │ │ │ +4 v 1432 w Fl(MPI)26 b Fd(:)i Fm(DRAFT)f Fd(June)h(20,)e(2025)p │ │ │ │ │ +2633 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 │ │ │ │ │ @@ -6228,17 +6219,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 1273 4 v 1439 100 a Fl(MPI)26 │ │ │ │ │ -b Fd(:)i Fm(DRAFT)110 b Fd(Ma)n(y)27 b(17,)g(2024)p 2546 │ │ │ │ │ -100 V 1273 w Fn(15)101 390 y(4.)42 b Fl(testGraph_Bcast)37 │ │ │ │ │ +TeXDict begin 15 14 bop 83 100 1267 4 v 1433 100 a Fl(MPI)26 │ │ │ │ │ +b Fd(:)i Fm(DRAFT)110 b Fd(June)28 b(20,)e(2025)p 2552 │ │ │ │ │ +100 V 1267 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 │ │ │ │ │ @@ -6330,17 +6321,17 @@ │ │ │ │ │ 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 1273 │ │ │ │ │ -4 v 1438 w Fl(MPI)26 b Fd(:)i Fm(DRAFT)f Fd(Ma)n(y)g(17,)g(2024)p │ │ │ │ │ -2627 100 V 456 390 a Fe({)41 b Fn(Use)f Fl(0)g Fn(for)f(a)g(real)g(or)g │ │ │ │ │ +TeXDict begin 16 15 bop 0 100 a Fn(16)p 166 100 1267 │ │ │ │ │ +4 v 1432 w Fl(MPI)26 b Fd(:)i Fm(DRAFT)f Fd(June)h(20,)e(2025)p │ │ │ │ │ +2633 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 │ │ │ │ │ @@ -6438,17 +6429,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 1273 4 v 1439 100 a Fl(MPI)26 │ │ │ │ │ -b Fd(:)i Fm(DRAFT)110 b Fd(Ma)n(y)27 b(17,)g(2024)p 2546 │ │ │ │ │ -100 V 1273 w Fn(17)307 390 y Ff(\210)42 b Fn(The)23 b │ │ │ │ │ +TeXDict begin 17 16 bop 83 100 1267 4 v 1433 100 a Fl(MPI)26 │ │ │ │ │ +b Fd(:)i Fm(DRAFT)110 b Fd(June)28 b(20,)e(2025)p 2552 │ │ │ │ │ +100 V 1267 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 │ │ │ │ │ @@ -6547,17 +6538,17 @@ │ │ │ │ │ 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 1273 │ │ │ │ │ -4 v 1438 w Fl(MPI)26 b Fd(:)i Fm(DRAFT)f Fd(Ma)n(y)g(17,)g(2024)p │ │ │ │ │ -2627 100 V 307 390 a Ff(\210)42 b Fn(The)28 b Fl(nrowA)d │ │ │ │ │ +TeXDict begin 18 17 bop 0 100 a Fn(18)p 166 100 1267 │ │ │ │ │ +4 v 1432 w Fl(MPI)26 b Fd(:)i Fm(DRAFT)f Fd(June)h(20,)e(2025)p │ │ │ │ │ +2633 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 │ │ │ │ │ @@ -6647,17 +6638,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 1273 4 v 1439 100 a Fl(MPI)26 │ │ │ │ │ -b Fd(:)i Fm(DRAFT)110 b Fd(Ma)n(y)27 b(17,)g(2024)p 2546 │ │ │ │ │ -100 V 1273 w Fn(19)307 390 y Ff(\210)42 b Fn(The)28 b │ │ │ │ │ +TeXDict begin 19 18 bop 83 100 1267 4 v 1433 100 a Fl(MPI)26 │ │ │ │ │ +b Fd(:)i Fm(DRAFT)110 b Fd(June)28 b(20,)e(2025)p 2552 │ │ │ │ │ +100 V 1267 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 Fn(for)g(ro)n(ws,)f │ │ │ │ │ @@ -6749,17 +6740,17 @@ │ │ │ │ │ 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 1273 │ │ │ │ │ -4 v 1438 w Fl(MPI)26 b Fd(:)i Fm(DRAFT)f Fd(Ma)n(y)g(17,)g(2024)p │ │ │ │ │ -2627 100 V 208 390 a Fn(from)j(the)i(structure)e(of)h(the)h(graph)e │ │ │ │ │ +TeXDict begin 20 19 bop 0 100 a Fn(20)p 166 100 1267 │ │ │ │ │ +4 v 1432 w Fl(MPI)26 b Fd(:)i Fm(DRAFT)f Fd(June)h(20,)e(2025)p │ │ │ │ │ +2633 100 V 208 390 a Fn(from)k(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 │ │ │ │ │ ├── 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 May 17, 2024 │ │ │ │ │ │ + 2 MPI : DRAFT June 20, 2025 │ │ │ │ │ │ – 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 May 17, 2024 3 │ │ │ │ │ │ + MPI : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 4 MPI : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 5 │ │ │ │ │ │ + MPI : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 6 MPI : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 7 │ │ │ │ │ │ + MPI : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 8 MPI : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 9 │ │ │ │ │ │ + MPI : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 10 MPI : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 11 │ │ │ │ │ │ + MPI : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 12 MPI : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 13 │ │ │ │ │ │ + MPI : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 14 MPI : DRAFT June 20, 2025 │ │ │ │ │ │ • 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 May 17, 2024 15 │ │ │ │ │ │ + MPI : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 16 MPI : DRAFT June 20, 2025 │ │ │ │ │ │ – 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 May 17, 2024 17 │ │ │ │ │ │ + MPI : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 18 MPI : DRAFT June 20, 2025 │ │ │ │ │ │ • 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 May 17, 2024 19 │ │ │ │ │ │ + MPI : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 20 MPI : DRAFT June 20, 2025 │ │ │ │ │ │ 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 2024.05.17:2218 │ │ │ │ │ +%DVIPSSource: TeX output 2025.06.20:0449 │ │ │ │ │ %%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 │ │ │ │ │ @@ -1227,22 +1227,21 @@ │ │ │ │ │ /UnderlinePosition -100 def │ │ │ │ │ /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 49 /one put │ │ │ │ │ dup 50 /two put │ │ │ │ │ -dup 52 /four put │ │ │ │ │ -dup 55 /seven put │ │ │ │ │ +dup 53 /five put │ │ │ │ │ dup 58 /colon put │ │ │ │ │ -dup 77 /M put │ │ │ │ │ -dup 97 /a put │ │ │ │ │ -dup 121 /y put │ │ │ │ │ +dup 74 /J put │ │ │ │ │ +dup 101 /e put │ │ │ │ │ +dup 110 /n put │ │ │ │ │ +dup 117 /u put │ │ │ │ │ readonly def │ │ │ │ │ currentdict end │ │ │ │ │ currentfile eexec │ │ │ │ │ D9D66F633B846AB284BCF8B0411B772DE5CE32340DC6F28AF40857E4451976E7 │ │ │ │ │ 5182433CF9F333A38BD841C0D4E68BF9E012EB32A8FFB76B5816306B5EDF7C99 │ │ │ │ │ 8B3A16D9B4BC056662E32C7CD0123DFAEB734C7532E64BBFBF5A60336E646716 │ │ │ │ │ EFB852C877F440D329172C71F1E5D59CE9473C26B8AEF7AD68EF0727B6EC2E0C │ │ │ │ │ @@ -1423,72 +1422,64 @@ │ │ │ │ │ 7CA1534C4D5B05FC33F83790ECFD7641DF3FB94289E2A1F6E7D29AB1228A867A │ │ │ │ │ 6E1EF0E9C6F899B491DC18401C2C0A05FFFED46A72C245F7529B8EA55A038082 │ │ │ │ │ 8512307217D2A233C37004085BA3AEE379269F9FA7D0ADB4B19A95CC2AFE686E │ │ │ │ │ 55D88E47257C1FE6F235FEA295910569FE6DD5995512562359CC821E85A6C7A5 │ │ │ │ │ 79B470A9E340A6985189FF8B6AF914A6B0ECF93F47903221F95DE894A8F05B05 │ │ │ │ │ B7D99CD533EC5F931B18E6B39BECF67FA2D6DD1AEC76772B068BE06335A94C05 │ │ │ │ │ 7A4DDEE77B66101DA855C17AC312600370B34E31F5EC3A01300A8EB60B4C9767 │ │ │ │ │ -1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004B9BA1CC │ │ │ │ │ -580D3C6BDA4DC1B80B4365F1C80512453FC5316EC2D928FB731C3D6403E3C18B │ │ │ │ │ -E8424D644DF5E9A2134229C5C91CA68DB8E85BA2BB40F538F585DA6FA4037718 │ │ │ │ │ -B8053EBBA1E765346BCD5BDAA6C38115D31611D8A87A2238C145F2DA2F92E4DF │ │ │ │ │ -3987BD9C4D2A3D460E8941A68B125BCD9EE4F9FD262C4C8A71F47A2C81975635 │ │ │ │ │ -F1B981C274C53FA2ACCDE4C9D0A7C62D6C1EFF91CFC6712CA6A9F333C9564FCB │ │ │ │ │ -2A70F0AD715A79B10A08AB069E2A3C93BC0AED19D0CA10134B8DDDE8AF548DB2 │ │ │ │ │ -3A4AAA9C29682CF135BB767DAA16169A127EB50A7EECEB6480CF56A7D0F8AC56 │ │ │ │ │ -4A5090B3D75A790372886AF568D94C8165975A05BFBFDF1FFBA45F70700BB9E0 │ │ │ │ │ -57F3249EF9E9C8AD9CBCF6E4FD592DC4CDD2CC7C0BC3130C1059096C657BE453 │ │ │ │ │ -A2CBACE93420210E27AF56CA229BD6D982FB68B3FDC6D44478B922C4231C47EE │ │ │ │ │ -E500232F6C11D92DEB955F66DF52B92B22E7352790CC2DCBAC53965D57AC2920 │ │ │ │ │ -68B7D520DE25047146EFEB06B9AD4E2A94243C7E5239F0BC2FC312B16051D52C │ │ │ │ │ -0B92C217B6B42997321AE4F8BB066754B7AA3F15069EF59224E8A442CE471AA7 │ │ │ │ │ -E8049A3DD9EDA09CCEE4998998661CF7DB35E952F6C65DAEB3013951C59F3E09 │ │ │ │ │ -157F313B0237876E1C0190F0473819570B8C0205AADF05D787CC00979CFB327A │ │ │ │ │ -289382B22DDA6F12804ED0ED5B179E36A995A2A59E1B66E75130DBE9109C813B │ │ │ │ │ -94403E0DEA8314A1E9DB474D7FA83C0BAFD08033E6A6215844C1D26BE15F1251 │ │ │ │ │ -A1605E8DF9A9C601ED37379530BC1C82BE5463C6C711C5652BFD6262485AA9CA │ │ │ │ │ -B8C4A117593001D08D980041E2A83C190DCE8E6CD3D334E5CC19FC05DB30F7F7 │ │ │ │ │ -24A305C4DBB31F0651392B99D44B4302333BDF7E326FD256DD75D309C6E73F85 │ │ │ │ │ -FA71B35FD1F9BEFF4C7A1076362EEB0A85492933B6006086A7B8C1928CF2D1EE │ │ │ │ │ -FD4344409257BB802C117E739960821CD3C88BFBA5669FF16F610AD638AF3677 │ │ │ │ │ -8674C985E6767253ED5769F71BEA5E9BB02A751F9E62EE2B18AC19D975FDEAE9 │ │ │ │ │ -8B8822367FF177A7E850766DE99ED3366D46464612926430012212A90F8E85F4 │ │ │ │ │ -4760B40D5B86B90819EE410382C23E86DCAF4F0FF5DFEB2C285965F4DCF2FB2B │ │ │ │ │ -457C0A0427A8D4ADA514E9DACD0F9367E1DA225DB21DA4DDAE33F2B529686D92 │ │ │ │ │ -AC085B345565F9DFFA012FD494DBB2E0B44A0787B2B72DC8D25399DAAE8864B7 │ │ │ │ │ -E84AA99DAFCEAF18F8B41882720316450F1B1CA48B418C9736E5CE4AFF996111 │ │ │ │ │ -5F7FE80958B6A3498508E9693CB134402D92E30D4C2939070D4647E13682290E │ │ │ │ │ -1D0820A3FCA7147157D09D1A40771F214EAE7DD743EA26839E535CA186C05CB8 │ │ │ │ │ -4874988AA1104D85AF0220FE7224344FF624E794BD2454E1C0AC971522FBECBA │ │ │ │ │ -B2497F25CD621B77EC5160973EF5ECC39C183DC051B0DFCB090194A2525BD96E │ │ │ │ │ -28593FDA80D8D259F039416D5F9AF0AD3C9A105B49DAF6E681921E369B7666C6 │ │ │ │ │ -2B73DB37447B00AE96317C2F1C44FB6E6EFD740BAB20FA03A8CE018EC8415582 │ │ │ │ │ -FB06E88A2971E3A480FB1EB4FE93CC7E5179721CAABEE88742B13CF0405F49F4 │ │ │ │ │ -945E587668C821D8C06D6847B6DF84CAFFCD4628670D551FC5F7236875BE1207 │ │ │ │ │ -634BA7F70A19B658FAE7D86F6D00ED28FBF29CC585DEE279325EEF8B0CCB6149 │ │ │ │ │ -E46E638C73D75148F18A636DBC2DD96ED34F68A5A09A3700B1EA34B2D142807C │ │ │ │ │ -F8709D81180783548EAE6F457BF968602076A1069163E3C15BBCEF659C6CF2E6 │ │ │ │ │ -0BB01BDC8E503802CC7969A5B8477E9788C5249B23B19669F5075E089738E49A │ │ │ │ │ -8671D7C1B1B47652F3D78BF2FF74EDB44BA5B092E8D5B85001E97F69D54AEEFC │ │ │ │ │ -88FC3CA1B0D5BAC39263B371005BCFA19AD197A31CC34D0BD55C2CA18C60C485 │ │ │ │ │ -5993F736EF1DD2C5D2B4D50B3D498861B4DF5E7AFF614BBCA4C2E6BECC0DCEF5 │ │ │ │ │ -95F0D686188014C530D8E37650CDCAE721B4AFB0F178BC744BDDDED45DAB7FEB │ │ │ │ │ -A10B975E26099E3DC61116D6BF554574F948895B88EEFE03DCC5351190836AD4 │ │ │ │ │ -EBC1AC55C6D099A8E7B0A372D290C481F44FA464B9C11A0BC991CB045E0AAAC4 │ │ │ │ │ -5C73CA43A4F17D1ADDD33D1B917FF95BFF411C8409F41553B1BC97DE47E3A1F4 │ │ │ │ │ -A5C1D1B7B1BF7E2507AC53956C141411F4F657E37981996DD7BB7ADB2CB6AE01 │ │ │ │ │ -73D0876B8F896F626D5022FE53BA34D5668BD698BE8D5CCAD083CBCEF440BE6A │ │ │ │ │ -8090EB1CDEE5F99C8988650BD4E539B357C31C597D8A9104A9D5967D4E906CAD │ │ │ │ │ -2A65575A884B1C5F6CC509E742FA9DDD66494F219178161AF72C50848E226A95 │ │ │ │ │ -A8C247FF9FF0BABD073021271B5C0692F9BE220071DAB09E5A026629371EE3C4 │ │ │ │ │ -A6E4FA94625D87A5B66EF077ED54C72B1052AEAA9637B30C76EF8EB04AD5F476 │ │ │ │ │ -D15F1C93C0BC6E0F67B366097BBED03FE82C040F9EF02866159B46854E11D44F │ │ │ │ │ -54AE6748A7E61B993A4EECD3B8BE3B5897A66BBCDFE24F65BC2AD5AB49048CF1 │ │ │ │ │ -647203823F84DF5CB483096F9D96AEE3A2855E479B72A14A67C633CE99C101CF │ │ │ │ │ -EFAE939BF9B02E710D │ │ │ │ │ +1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004ACD1870 │ │ │ │ │ +A5EA947858F5795870BFE1343AD803FB854BF8F5A4E794E8EC57BE41DB5B8734 │ │ │ │ │ +13E47950F29A81EA0C81EA798863883D7F41F78325CA190CBBFFE822AE494550 │ │ │ │ │ +4BE83703071FC9512D128927AF3F63CEF8F86ABE1E15D7B4DDD39576E7DFF45E │ │ │ │ │ +3CB4115AAB1830DE8647B915DB4BEBEB5235C281E098B899BAB951D8D5798F01 │ │ │ │ │ +7F7C47336D31438E5126738AFEAB29E9A7CBE06DE4DD604477B542D2620DFD58 │ │ │ │ │ +28FE34238572F23C5A8EB7ACEE1E154DA13FC1A5AA67A3BA8C5CDFB2B80312C9 │ │ │ │ │ +BC9FAE56D08DDFA9498E6EF0D0F6BD18B3923E0B670B0740528BC843610736CB │ │ │ │ │ +80228C105C2F72C3C22D610C3D8C268DEEA2AEEE3221E198E79FE2966487360C │ │ │ │ │ +84AE08AC326F48B21447652121B1EB68AF856055EEA65B6B625BF622CBFC2D1C │ │ │ │ │ +EF943CC4CAF2C715782C9EF9A9BA4689BFC6B6A82F8D55795BE8111E2C7DE520 │ │ │ │ │ +367362304B6A48186C842033E715A46265A352472F4F7313248EBCD26BEA97E7 │ │ │ │ │ +B814A61D4B7ADCB5C5F21AA34E0C1269E8426DBFB511DE6E26B960456C8F8520 │ │ │ │ │ +5F0DD382289A62AF0B935EDB5B2394538C5F0EE72962D2F98F3C38CD7C027B9F │ │ │ │ │ +E230E67E40FEFBDED06B3423C9DFD669E6B5BC913E0FF75786A64A6C11D4FE89 │ │ │ │ │ +1B918DC0E953C52CFD153063CD0D2A78B43F8712243845E6F2CBA1DB610F403D │ │ │ │ │ +A98D06D95FF44C7AC029092B666A8B0DCEA95B34F5ACC10E8611BADE6A24469C │ │ │ │ │ +0C01D95BFB445FA22CD38D033E4D24E006BB9D54EE41EF7AD5AC9C299721F61A │ │ │ │ │ +F01B6EDCDF428BD9195A13C5B1027358F8A203F828A1DD9622243B2D76C6F1BA │ │ │ │ │ +9F2D7E9D4879FC668ABC750CD25415DC6CCF2257C28F78D3F9BE499CC0FF2F80 │ │ │ │ │ +2C2CD1DEFABD6668FCA76E1D629A344333E33DA24B86D2E9F8F5EE1C29974640 │ │ │ │ │ +C3E78E999BAB313400041DADDDFDBFFCC419F129A84F4D412B79E8BE4511CA00 │ │ │ │ │ +F92A4F3CDD2E51345D3965C104F06B6503445DC20224CB7606A9D7D5F9EE45E6 │ │ │ │ │ +1B2963DA96AA2AB1BA5BE29656E666E4D0E122DE58EEA68E04ED76438DA03E65 │ │ │ │ │ +B80055A86B7B2A26BAE6BBB8835E17F9696E9B3CD34571BA75C76D4D2CCC48F1 │ │ │ │ │ +7534C1EF9127E374D65D05B8072E08D6C72A0B4A35EA0DD717743C66D105CCD8 │ │ │ │ │ +7355F13E9C38C1A4351624E689ED7909100942FA0474842EE44DEC3279E1A1CD │ │ │ │ │ +8064666EB845CA7C3E906B67C0BF96A28D514DB2E4A1E4AF287350B03762A2CF │ │ │ │ │ +13B18AC3F5D2F3B74A1D50267C03EFB74B888E1D24ABEEA4A885F4D0BF14C0D8 │ │ │ │ │ +289AC79D6D98E2A2C831672FB1F3457564CD161ADC3AF610D88201AB5B0C10CB │ │ │ │ │ +5ECCC2D5C4AF39C8CB3044BF9EC791BA45D29C2B51EA0483D19822C264CE6FA3 │ │ │ │ │ +5C97F2DF5A78CB93528E99B9ED7CB121C83130C129B849B52A36EBD88AF19DD3 │ │ │ │ │ +C5CABE831027388EF86BD5CBD90AAAC089775938A321C44D4DDA67A51312D8AB │ │ │ │ │ +C509DDBE7044A107AB2BE9C4C9556F85C529B174A7778B489BF28EC07A834542 │ │ │ │ │ +8B31F2925C21FB2096877711F998763D5A8495002B8E080AF8DBB1B3106EDDBA │ │ │ │ │ +35121D52E0846A7AF3ABEDF87BDE4FA665673A9B80CA538B98F873947AA17EF4 │ │ │ │ │ +9BB182917E9D79BC7EC681E93710D6A1D6B0E4A7FA9452FC1C431808174F3AB7 │ │ │ │ │ +F3914FBC86CB34E8583457243C3C7BE4BC166C7397689BC6FFB82EA2967E88EE │ │ │ │ │ +464F96EDA144DE2B64401B8E577ABCA2D826FE0B92E21FFAE3E81EBB6B6EB36E │ │ │ │ │ +9B1A8FE3884CA398C03135FD49D51724FC1268E9482E41FAEA2FC6C809006B8F │ │ │ │ │ +5D4F9E038450AD3A6041C16FD1C7E5FC80C0E033CE57E64863E014531D94DF1E │ │ │ │ │ +31D7D038AFCB60715AA73C1E96F113A24C5AF35BBEB61C4D079ED034ED83AA4A │ │ │ │ │ +E12448E618330463304788BCF40561CD63167B3BF144F408E2B89E60B8BA13EF │ │ │ │ │ +3B57D286FD23D4FA8BAEFF98DC1188B1982956CC1DCAEFC7D949B7B4E3BE8F8A │ │ │ │ │ +BFE2C9D938DD13EFEE7123576608D9396F260907DA98AE2D3DD5822306CBC8A6 │ │ │ │ │ +B083C697DDA3C62EE7879436A9FD8EE0034B105105B3F122F893EA2126EBE8A9 │ │ │ │ │ +5CBF2BD248DD9FBEF0040C25797BD13B69A8C9F0D4E4F935C61ED30487CCDB1A │ │ │ │ │ +0339006E78EE1755929D2412776EC7DB1F666DBDD28EA8AC7397F809C7F38A41 │ │ │ │ │ +5B3BF6C75F4F35C90141EB08377AF452CF840FEA938805F9D14E02DC29215B4E │ │ │ │ │ +F1EB │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ @@ -5183,24 +5174,24 @@ │ │ │ │ │ 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 23[45 19[83 18[25 2[45 │ │ │ │ │ -2[45 1[45 45 45 3[25 44[{}10 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 │ │ │ │ │ +119.552 /CMBX12 rf /Fe 138[51 6[51 8[40 26[47 15[25 4[45 │ │ │ │ │ +2[45 1[45 3[25 44[{}9 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 │ │ │ │ │ @@ -5305,17 +5296,17 @@ │ │ │ │ │ 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 1208 4 v │ │ │ │ │ -1390 w Fn(MSMD)29 b Fe(:)i Fk(DRAFT)f Fe(Ma)m(y)h(17,)h(2024)p │ │ │ │ │ -2692 100 V 0 399 a Fo(W)-8 b(e)32 b(in)m(tend)e(to)h(add)f(more)g │ │ │ │ │ +TeXDict begin 2 1 bop 0 100 a Fo(2)p 136 100 1201 4 v │ │ │ │ │ +1383 w Fn(MSMD)29 b Fe(:)i Fk(DRAFT)f Fe(June)f(20,)j(2025)p │ │ │ │ │ +2699 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 │ │ │ │ │ @@ -5376,17 +5367,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 1208 4 v 1389 100 a Fn(MSMD)30 │ │ │ │ │ -b Fe(:)g Fk(DRAFT)121 b Fe(Ma)m(y)32 b(17,)f(2024)p 2645 │ │ │ │ │ -100 V 1208 w Fo(3)137 399 y Fm(\210)45 b Fn(MSMDstageInfo)25 │ │ │ │ │ +TeXDict begin 3 2 bop 91 100 1201 4 v 1382 100 a Fn(MSMD)30 │ │ │ │ │ +b Fe(:)g Fk(DRAFT)121 b Fe(June)30 b(20,)h(2025)p 2652 │ │ │ │ │ +100 V 1201 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 │ │ │ │ │ @@ -5446,17 +5437,17 @@ │ │ │ │ │ (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 1208 4 v │ │ │ │ │ -1390 w Fn(MSMD)29 b Fe(:)i Fk(DRAFT)f Fe(Ma)m(y)h(17,)h(2024)p │ │ │ │ │ -2692 100 V 227 399 a Fo(The)e(default)h(v)-5 b(alue)31 │ │ │ │ │ +TeXDict begin 4 3 bop 0 100 a Fo(4)p 136 100 1201 4 v │ │ │ │ │ +1383 w Fn(MSMD)29 b Fe(:)i Fk(DRAFT)f Fe(June)f(20,)j(2025)p │ │ │ │ │ +2699 100 V 227 399 a Fo(The)e(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 │ │ │ │ │ @@ -5501,17 +5492,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 1208 4 v 1389 100 a Fn(MSMD)30 │ │ │ │ │ -b Fe(:)g Fk(DRAFT)121 b Fe(Ma)m(y)32 b(17,)f(2024)p 2645 │ │ │ │ │ -100 V 1208 w Fo(5)0 399 y Fc(1.1.3)112 b Fb(MSMDstageInfo)41 │ │ │ │ │ +TeXDict begin 5 4 bop 91 100 1201 4 v 1382 100 a Fn(MSMD)30 │ │ │ │ │ +b Fe(:)g Fk(DRAFT)121 b Fe(June)30 b(20,)h(2025)p 2652 │ │ │ │ │ +100 V 1201 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 │ │ │ │ │ @@ -5553,17 +5544,17 @@ │ │ │ │ │ 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 1208 4 v │ │ │ │ │ -1390 w Fn(MSMD)29 b Fe(:)i Fk(DRAFT)f Fe(Ma)m(y)h(17,)h(2024)p │ │ │ │ │ -2692 100 V 137 399 a Fm(\210)45 b Fn(int)i(stage)29 b │ │ │ │ │ +TeXDict begin 6 5 bop 0 100 a Fo(6)p 136 100 1201 4 v │ │ │ │ │ +1383 w Fn(MSMD)29 b Fe(:)i Fk(DRAFT)f Fe(June)f(20,)j(2025)p │ │ │ │ │ +2699 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 │ │ │ │ │ @@ -5620,17 +5611,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 1208 4 v 1389 100 a Fn(MSMD)30 │ │ │ │ │ -b Fe(:)g Fk(DRAFT)121 b Fe(Ma)m(y)32 b(17,)f(2024)p 2645 │ │ │ │ │ -100 V 1208 w Fo(7)0 399 y Fc(1.2.2)112 b(Utilit)m(y)38 │ │ │ │ │ +TeXDict begin 7 6 bop 91 100 1201 4 v 1382 100 a Fn(MSMD)30 │ │ │ │ │ +b Fe(:)g Fk(DRAFT)121 b Fe(June)30 b(20,)h(2025)p 2652 │ │ │ │ │ +100 V 1201 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 │ │ │ │ │ @@ -5683,17 +5674,17 @@ │ │ │ │ │ (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 1208 4 v │ │ │ │ │ -1390 w Fn(MSMD)29 b Fe(:)i Fk(DRAFT)f Fe(Ma)m(y)h(17,)h(2024)p │ │ │ │ │ -2692 100 V 0 399 a Fc(1.3.2)112 b(Initialization)39 b(metho)s(ds)f(|)g │ │ │ │ │ +TeXDict begin 8 7 bop 0 100 a Fo(8)p 136 100 1201 4 v │ │ │ │ │ +1383 w Fn(MSMD)29 b Fe(:)i Fk(DRAFT)f Fe(June)f(20,)j(2025)p │ │ │ │ │ +2699 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 │ │ │ │ │ @@ -5760,17 +5751,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 1208 4 v 1389 100 a Fn(MSMD)30 │ │ │ │ │ -b Fe(:)g Fk(DRAFT)121 b Fe(Ma)m(y)32 b(17,)f(2024)p 2645 │ │ │ │ │ -100 V 1208 w Fo(9)227 399 y(\014lls)j(the)h Fn(IV)f Fo(ob)5 │ │ │ │ │ +TeXDict begin 9 8 bop 91 100 1201 4 v 1382 100 a Fn(MSMD)30 │ │ │ │ │ +b Fe(:)g Fk(DRAFT)121 b Fe(June)30 b(20,)h(2025)p 2652 │ │ │ │ │ +100 V 1201 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 │ │ │ │ │ @@ -5828,17 +5819,17 @@ │ │ │ │ │ 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 1185 4 │ │ │ │ │ -v 1368 w Fn(MSMD)29 b Fe(:)h Fk(DRAFT)g Fe(Ma)m(y)i(17,)f(2024)p │ │ │ │ │ -2715 100 V 111 399 a Fo(6.)46 b Fn(void)h(MSMD_cleanSubtreeList)42 │ │ │ │ │ +TeXDict begin 10 9 bop 0 100 a Fo(10)p 182 100 1178 4 │ │ │ │ │ +v 1361 w Fn(MSMD)29 b Fe(:)h Fk(DRAFT)h Fe(June)e(20,)i(2025)p │ │ │ │ │ +2722 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 │ │ │ │ │ @@ -5903,17 +5894,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 1185 4 v 1367 100 a Fn(MSMD)29 │ │ │ │ │ -b Fe(:)h Fk(DRAFT)121 b Fe(Ma)m(y)32 b(17,)f(2024)p 2622 │ │ │ │ │ -100 V 1185 w Fo(11)0 399 y Fd(1.5)135 b(Driv)l(er)46 │ │ │ │ │ +TeXDict begin 11 10 bop 91 100 1178 4 v 1360 100 a Fn(MSMD)29 │ │ │ │ │ +b Fe(:)h Fk(DRAFT)122 b Fe(June)29 b(20,)i(2025)p 2629 │ │ │ │ │ +100 V 1178 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 │ │ │ │ │ @@ -5975,17 +5966,17 @@ │ │ │ │ │ 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 1185 │ │ │ │ │ -4 v 1368 w Fn(MSMD)29 b Fe(:)h Fk(DRAFT)g Fe(Ma)m(y)i(17,)f(2024)p │ │ │ │ │ -2715 100 V 337 399 a Fm(\210)45 b Fo(The)38 b Fn(outNewToOldIVfile)c │ │ │ │ │ +TeXDict begin 12 11 bop 0 100 a Fo(12)p 182 100 1178 │ │ │ │ │ +4 v 1361 w Fn(MSMD)29 b Fe(:)h Fk(DRAFT)h Fe(June)e(20,)i(2025)p │ │ │ │ │ +2722 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 │ │ │ │ │ ├── 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 May 17, 2024 │ │ │ │ │ │ + 2 MSMD : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 3 │ │ │ │ │ │ + MSMD : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 4 MSMD : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 5 │ │ │ │ │ │ + MSMD : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 6 MSMD : DRAFT June 20, 2025 │ │ │ │ │ │ • 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 May 17, 2024 7 │ │ │ │ │ │ + MSMD : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 8 MSMD : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 9 │ │ │ │ │ │ + MSMD : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 10 MSMD : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 11 │ │ │ │ │ │ + MSMD : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 12 MSMD : DRAFT June 20, 2025 │ │ │ │ │ │ • 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 2024.05.17:2218 │ │ │ │ │ +%DVIPSSource: TeX output 2025.06.20:0450 │ │ │ │ │ %%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 │ │ │ │ │ @@ -1599,22 +1599,21 @@ │ │ │ │ │ /UnderlinePosition -100 def │ │ │ │ │ /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 49 /one put │ │ │ │ │ dup 50 /two put │ │ │ │ │ -dup 52 /four put │ │ │ │ │ -dup 55 /seven put │ │ │ │ │ +dup 53 /five put │ │ │ │ │ dup 58 /colon put │ │ │ │ │ -dup 77 /M put │ │ │ │ │ -dup 97 /a put │ │ │ │ │ -dup 121 /y put │ │ │ │ │ +dup 74 /J put │ │ │ │ │ +dup 101 /e put │ │ │ │ │ +dup 110 /n put │ │ │ │ │ +dup 117 /u put │ │ │ │ │ readonly def │ │ │ │ │ currentdict end │ │ │ │ │ currentfile eexec │ │ │ │ │ D9D66F633B846AB284BCF8B0411B772DE5CE32340DC6F28AF40857E4451976E7 │ │ │ │ │ 5182433CF9F333A38BD841C0D4E68BF9E012EB32A8FFB76B5816306B5EDF7C99 │ │ │ │ │ 8B3A16D9B4BC056662E32C7CD0123DFAEB734C7532E64BBFBF5A60336E646716 │ │ │ │ │ EFB852C877F440D329172C71F1E5D59CE9473C26B8AEF7AD68EF0727B6EC2E0C │ │ │ │ │ @@ -1795,72 +1794,64 @@ │ │ │ │ │ 7CA1534C4D5B05FC33F83790ECFD7641DF3FB94289E2A1F6E7D29AB1228A867A │ │ │ │ │ 6E1EF0E9C6F899B491DC18401C2C0A05FFFED46A72C245F7529B8EA55A038082 │ │ │ │ │ 8512307217D2A233C37004085BA3AEE379269F9FA7D0ADB4B19A95CC2AFE686E │ │ │ │ │ 55D88E47257C1FE6F235FEA295910569FE6DD5995512562359CC821E85A6C7A5 │ │ │ │ │ 79B470A9E340A6985189FF8B6AF914A6B0ECF93F47903221F95DE894A8F05B05 │ │ │ │ │ B7D99CD533EC5F931B18E6B39BECF67FA2D6DD1AEC76772B068BE06335A94C05 │ │ │ │ │ 7A4DDEE77B66101DA855C17AC312600370B34E31F5EC3A01300A8EB60B4C9767 │ │ │ │ │ -1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004B9BA1CC │ │ │ │ │ -580D3C6BDA4DC1B80B4365F1C80512453FC5316EC2D928FB731C3D6403E3C18B │ │ │ │ │ -E8424D644DF5E9A2134229C5C91CA68DB8E85BA2BB40F538F585DA6FA4037718 │ │ │ │ │ -B8053EBBA1E765346BCD5BDAA6C38115D31611D8A87A2238C145F2DA2F92E4DF │ │ │ │ │ -3987BD9C4D2A3D460E8941A68B125BCD9EE4F9FD262C4C8A71F47A2C81975635 │ │ │ │ │ -F1B981C274C53FA2ACCDE4C9D0A7C62D6C1EFF91CFC6712CA6A9F333C9564FCB │ │ │ │ │ -2A70F0AD715A79B10A08AB069E2A3C93BC0AED19D0CA10134B8DDDE8AF548DB2 │ │ │ │ │ -3A4AAA9C29682CF135BB767DAA16169A127EB50A7EECEB6480CF56A7D0F8AC56 │ │ │ │ │ -4A5090B3D75A790372886AF568D94C8165975A05BFBFDF1FFBA45F70700BB9E0 │ │ │ │ │ -57F3249EF9E9C8AD9CBCF6E4FD592DC4CDD2CC7C0BC3130C1059096C657BE453 │ │ │ │ │ -A2CBACE93420210E27AF56CA229BD6D982FB68B3FDC6D44478B922C4231C47EE │ │ │ │ │ -E500232F6C11D92DEB955F66DF52B92B22E7352790CC2DCBAC53965D57AC2920 │ │ │ │ │ -68B7D520DE25047146EFEB06B9AD4E2A94243C7E5239F0BC2FC312B16051D52C │ │ │ │ │ -0B92C217B6B42997321AE4F8BB066754B7AA3F15069EF59224E8A442CE471AA7 │ │ │ │ │ -E8049A3DD9EDA09CCEE4998998661CF7DB35E952F6C65DAEB3013951C59F3E09 │ │ │ │ │ -157F313B0237876E1C0190F0473819570B8C0205AADF05D787CC00979CFB327A │ │ │ │ │ -289382B22DDA6F12804ED0ED5B179E36A995A2A59E1B66E75130DBE9109C813B │ │ │ │ │ -94403E0DEA8314A1E9DB474D7FA83C0BAFD08033E6A6215844C1D26BE15F1251 │ │ │ │ │ -A1605E8DF9A9C601ED37379530BC1C82BE5463C6C711C5652BFD6262485AA9CA │ │ │ │ │ -B8C4A117593001D08D980041E2A83C190DCE8E6CD3D334E5CC19FC05DB30F7F7 │ │ │ │ │ -24A305C4DBB31F0651392B99D44B4302333BDF7E326FD256DD75D309C6E73F85 │ │ │ │ │ -FA71B35FD1F9BEFF4C7A1076362EEB0A85492933B6006086A7B8C1928CF2D1EE │ │ │ │ │ -FD4344409257BB802C117E739960821CD3C88BFBA5669FF16F610AD638AF3677 │ │ │ │ │ -8674C985E6767253ED5769F71BEA5E9BB02A751F9E62EE2B18AC19D975FDEAE9 │ │ │ │ │ -8B8822367FF177A7E850766DE99ED3366D46464612926430012212A90F8E85F4 │ │ │ │ │ -4760B40D5B86B90819EE410382C23E86DCAF4F0FF5DFEB2C285965F4DCF2FB2B │ │ │ │ │ -457C0A0427A8D4ADA514E9DACD0F9367E1DA225DB21DA4DDAE33F2B529686D92 │ │ │ │ │ -AC085B345565F9DFFA012FD494DBB2E0B44A0787B2B72DC8D25399DAAE8864B7 │ │ │ │ │ -E84AA99DAFCEAF18F8B41882720316450F1B1CA48B418C9736E5CE4AFF996111 │ │ │ │ │ -5F7FE80958B6A3498508E9693CB134402D92E30D4C2939070D4647E13682290E │ │ │ │ │ -1D0820A3FCA7147157D09D1A40771F214EAE7DD743EA26839E535CA186C05CB8 │ │ │ │ │ -4874988AA1104D85AF0220FE7224344FF624E794BD2454E1C0AC971522FBECBA │ │ │ │ │ -B2497F25CD621B77EC5160973EF5ECC39C183DC051B0DFCB090194A2525BD96E │ │ │ │ │ -28593FDA80D8D259F039416D5F9AF0AD3C9A105B49DAF6E681921E369B7666C6 │ │ │ │ │ -2B73DB37447B00AE96317C2F1C44FB6E6EFD740BAB20FA03A8CE018EC8415582 │ │ │ │ │ -FB06E88A2971E3A480FB1EB4FE93CC7E5179721CAABEE88742B13CF0405F49F4 │ │ │ │ │ -945E587668C821D8C06D6847B6DF84CAFFCD4628670D551FC5F7236875BE1207 │ │ │ │ │ -634BA7F70A19B658FAE7D86F6D00ED28FBF29CC585DEE279325EEF8B0CCB6149 │ │ │ │ │ -E46E638C73D75148F18A636DBC2DD96ED34F68A5A09A3700B1EA34B2D142807C │ │ │ │ │ -F8709D81180783548EAE6F457BF968602076A1069163E3C15BBCEF659C6CF2E6 │ │ │ │ │ -0BB01BDC8E503802CC7969A5B8477E9788C5249B23B19669F5075E089738E49A │ │ │ │ │ -8671D7C1B1B47652F3D78BF2FF74EDB44BA5B092E8D5B85001E97F69D54AEEFC │ │ │ │ │ -88FC3CA1B0D5BAC39263B371005BCFA19AD197A31CC34D0BD55C2CA18C60C485 │ │ │ │ │ -5993F736EF1DD2C5D2B4D50B3D498861B4DF5E7AFF614BBCA4C2E6BECC0DCEF5 │ │ │ │ │ -95F0D686188014C530D8E37650CDCAE721B4AFB0F178BC744BDDDED45DAB7FEB │ │ │ │ │ -A10B975E26099E3DC61116D6BF554574F948895B88EEFE03DCC5351190836AD4 │ │ │ │ │ -EBC1AC55C6D099A8E7B0A372D290C481F44FA464B9C11A0BC991CB045E0AAAC4 │ │ │ │ │ -5C73CA43A4F17D1ADDD33D1B917FF95BFF411C8409F41553B1BC97DE47E3A1F4 │ │ │ │ │ -A5C1D1B7B1BF7E2507AC53956C141411F4F657E37981996DD7BB7ADB2CB6AE01 │ │ │ │ │ -73D0876B8F896F626D5022FE53BA34D5668BD698BE8D5CCAD083CBCEF440BE6A │ │ │ │ │ -8090EB1CDEE5F99C8988650BD4E539B357C31C597D8A9104A9D5967D4E906CAD │ │ │ │ │ -2A65575A884B1C5F6CC509E742FA9DDD66494F219178161AF72C50848E226A95 │ │ │ │ │ -A8C247FF9FF0BABD073021271B5C0692F9BE220071DAB09E5A026629371EE3C4 │ │ │ │ │ -A6E4FA94625D87A5B66EF077ED54C72B1052AEAA9637B30C76EF8EB04AD5F476 │ │ │ │ │ -D15F1C93C0BC6E0F67B366097BBED03FE82C040F9EF02866159B46854E11D44F │ │ │ │ │ -54AE6748A7E61B993A4EECD3B8BE3B5897A66BBCDFE24F65BC2AD5AB49048CF1 │ │ │ │ │ -647203823F84DF5CB483096F9D96AEE3A2855E479B72A14A67C633CE99C101CF │ │ │ │ │ -EFAE939BF9B02E710D │ │ │ │ │ +1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004ACD1870 │ │ │ │ │ +A5EA947858F5795870BFE1343AD803FB854BF8F5A4E794E8EC57BE41DB5B8734 │ │ │ │ │ +13E47950F29A81EA0C81EA798863883D7F41F78325CA190CBBFFE822AE494550 │ │ │ │ │ +4BE83703071FC9512D128927AF3F63CEF8F86ABE1E15D7B4DDD39576E7DFF45E │ │ │ │ │ +3CB4115AAB1830DE8647B915DB4BEBEB5235C281E098B899BAB951D8D5798F01 │ │ │ │ │ +7F7C47336D31438E5126738AFEAB29E9A7CBE06DE4DD604477B542D2620DFD58 │ │ │ │ │ +28FE34238572F23C5A8EB7ACEE1E154DA13FC1A5AA67A3BA8C5CDFB2B80312C9 │ │ │ │ │ +BC9FAE56D08DDFA9498E6EF0D0F6BD18B3923E0B670B0740528BC843610736CB │ │ │ │ │ +80228C105C2F72C3C22D610C3D8C268DEEA2AEEE3221E198E79FE2966487360C │ │ │ │ │ +84AE08AC326F48B21447652121B1EB68AF856055EEA65B6B625BF622CBFC2D1C │ │ │ │ │ +EF943CC4CAF2C715782C9EF9A9BA4689BFC6B6A82F8D55795BE8111E2C7DE520 │ │ │ │ │ +367362304B6A48186C842033E715A46265A352472F4F7313248EBCD26BEA97E7 │ │ │ │ │ +B814A61D4B7ADCB5C5F21AA34E0C1269E8426DBFB511DE6E26B960456C8F8520 │ │ │ │ │ +5F0DD382289A62AF0B935EDB5B2394538C5F0EE72962D2F98F3C38CD7C027B9F │ │ │ │ │ +E230E67E40FEFBDED06B3423C9DFD669E6B5BC913E0FF75786A64A6C11D4FE89 │ │ │ │ │ +1B918DC0E953C52CFD153063CD0D2A78B43F8712243845E6F2CBA1DB610F403D │ │ │ │ │ +A98D06D95FF44C7AC029092B666A8B0DCEA95B34F5ACC10E8611BADE6A24469C │ │ │ │ │ +0C01D95BFB445FA22CD38D033E4D24E006BB9D54EE41EF7AD5AC9C299721F61A │ │ │ │ │ +F01B6EDCDF428BD9195A13C5B1027358F8A203F828A1DD9622243B2D76C6F1BA │ │ │ │ │ +9F2D7E9D4879FC668ABC750CD25415DC6CCF2257C28F78D3F9BE499CC0FF2F80 │ │ │ │ │ +2C2CD1DEFABD6668FCA76E1D629A344333E33DA24B86D2E9F8F5EE1C29974640 │ │ │ │ │ +C3E78E999BAB313400041DADDDFDBFFCC419F129A84F4D412B79E8BE4511CA00 │ │ │ │ │ +F92A4F3CDD2E51345D3965C104F06B6503445DC20224CB7606A9D7D5F9EE45E6 │ │ │ │ │ +1B2963DA96AA2AB1BA5BE29656E666E4D0E122DE58EEA68E04ED76438DA03E65 │ │ │ │ │ +B80055A86B7B2A26BAE6BBB8835E17F9696E9B3CD34571BA75C76D4D2CCC48F1 │ │ │ │ │ +7534C1EF9127E374D65D05B8072E08D6C72A0B4A35EA0DD717743C66D105CCD8 │ │ │ │ │ +7355F13E9C38C1A4351624E689ED7909100942FA0474842EE44DEC3279E1A1CD │ │ │ │ │ +8064666EB845CA7C3E906B67C0BF96A28D514DB2E4A1E4AF287350B03762A2CF │ │ │ │ │ +13B18AC3F5D2F3B74A1D50267C03EFB74B888E1D24ABEEA4A885F4D0BF14C0D8 │ │ │ │ │ +289AC79D6D98E2A2C831672FB1F3457564CD161ADC3AF610D88201AB5B0C10CB │ │ │ │ │ +5ECCC2D5C4AF39C8CB3044BF9EC791BA45D29C2B51EA0483D19822C264CE6FA3 │ │ │ │ │ +5C97F2DF5A78CB93528E99B9ED7CB121C83130C129B849B52A36EBD88AF19DD3 │ │ │ │ │ +C5CABE831027388EF86BD5CBD90AAAC089775938A321C44D4DDA67A51312D8AB │ │ │ │ │ +C509DDBE7044A107AB2BE9C4C9556F85C529B174A7778B489BF28EC07A834542 │ │ │ │ │ +8B31F2925C21FB2096877711F998763D5A8495002B8E080AF8DBB1B3106EDDBA │ │ │ │ │ +35121D52E0846A7AF3ABEDF87BDE4FA665673A9B80CA538B98F873947AA17EF4 │ │ │ │ │ +9BB182917E9D79BC7EC681E93710D6A1D6B0E4A7FA9452FC1C431808174F3AB7 │ │ │ │ │ +F3914FBC86CB34E8583457243C3C7BE4BC166C7397689BC6FFB82EA2967E88EE │ │ │ │ │ +464F96EDA144DE2B64401B8E577ABCA2D826FE0B92E21FFAE3E81EBB6B6EB36E │ │ │ │ │ +9B1A8FE3884CA398C03135FD49D51724FC1268E9482E41FAEA2FC6C809006B8F │ │ │ │ │ +5D4F9E038450AD3A6041C16FD1C7E5FC80C0E033CE57E64863E014531D94DF1E │ │ │ │ │ +31D7D038AFCB60715AA73C1E96F113A24C5AF35BBEB61C4D079ED034ED83AA4A │ │ │ │ │ +E12448E618330463304788BCF40561CD63167B3BF144F408E2B89E60B8BA13EF │ │ │ │ │ +3B57D286FD23D4FA8BAEFF98DC1188B1982956CC1DCAEFC7D949B7B4E3BE8F8A │ │ │ │ │ +BFE2C9D938DD13EFEE7123576608D9396F260907DA98AE2D3DD5822306CBC8A6 │ │ │ │ │ +B083C697DDA3C62EE7879436A9FD8EE0034B105105B3F122F893EA2126EBE8A9 │ │ │ │ │ +5CBF2BD248DD9FBEF0040C25797BD13B69A8C9F0D4E4F935C61ED30487CCDB1A │ │ │ │ │ +0339006E78EE1755929D2412776EC7DB1F666DBDD28EA8AC7397F809C7F38A41 │ │ │ │ │ +5B3BF6C75F4F35C90141EB08377AF452CF840FEA938805F9D14E02DC29215B4E │ │ │ │ │ +F1EB │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ @@ -4994,16 +4985,16 @@ │ │ │ │ │ X/FBB X/IEn X │ │ │ │ │ %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 │ │ │ │ │ -23[42 19[76 18[23 2[42 2[42 1[42 42 42 3[23 44[{}10 83.022 │ │ │ │ │ +16[67 67 67 2[37 46[{}26 119.552 /CMBX12 rf /Fg 138[46 │ │ │ │ │ +6[46 8[37 26[43 15[23 4[42 2[42 1[42 3[23 44[{}9 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 │ │ │ │ │ @@ -5128,17 +5119,17 @@ │ │ │ │ │ (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 1072 4 v │ │ │ │ │ -1237 w Fi(Multithreaded)22 b Fg(:)37 b Fh(DRAFT)27 b │ │ │ │ │ -Fg(Ma)n(y)g(17,)g(2024)p 2829 100 V 0 390 a Ff(1.1)135 │ │ │ │ │ +TeXDict begin 2 1 bop 0 100 a Fn(2)p 125 100 1065 4 v │ │ │ │ │ +1230 w Fi(Multithreaded)23 b Fg(:)37 b Fh(DRAFT)27 b │ │ │ │ │ +Fg(June)g(20,)g(2025)p 2835 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 │ │ │ │ │ @@ -5246,17 +5237,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 1072 4 v 1237 100 a Fi(Multithreaded)23 │ │ │ │ │ -b Fg(:)36 b Fh(DRAFT)111 b Fg(Ma)n(y)27 b(17,)f(2024)p │ │ │ │ │ -2789 100 V 1072 w Fn(3)208 390 y(arra)n(y)e(of)i(length)h(1)f(or)f(2.) │ │ │ │ │ +TeXDict begin 3 2 bop 83 100 1065 4 v 1231 100 a Fi(Multithreaded)22 │ │ │ │ │ +b Fg(:)37 b Fh(DRAFT)110 b Fg(June)28 b(20,)f(2025)p │ │ │ │ │ +2796 100 V 1065 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 │ │ │ │ │ @@ -5356,17 +5347,17 @@ │ │ │ │ │ (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 1072 4 v │ │ │ │ │ -1237 w Fi(Multithreaded)22 b Fg(:)37 b Fh(DRAFT)27 b │ │ │ │ │ -Fg(Ma)n(y)g(17,)g(2024)p 2829 100 V 307 390 a Fc(\210)42 │ │ │ │ │ +TeXDict begin 4 3 bop 0 100 a Fn(4)p 125 100 1065 4 v │ │ │ │ │ +1230 w Fi(Multithreaded)23 b Fg(:)37 b Fh(DRAFT)27 b │ │ │ │ │ +Fg(June)g(20,)g(2025)p 2835 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 │ │ │ │ │ @@ -5437,27 +5428,27 @@ │ │ │ │ │ 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 1072 4 v 1237 100 a Fi(Multithreaded)23 │ │ │ │ │ -b Fg(:)36 b Fh(DRAFT)111 b Fg(Ma)n(y)27 b(17,)f(2024)p │ │ │ │ │ -2789 100 V 1072 w Fn(5)208 390 y(from)31 b 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(submatrices)f(to)h(threads.)208 689 y(The)j(map)h(from)f(fron)n │ │ │ │ │ -(ts)g(to)h(pro)r(cesses)e(that)i(o)n(wn)f(them)h(is)f(giv)n(en)g(in)h │ │ │ │ │ -(the)g Fi(ownersIV)c Fn(ob)5 b(ject.)64 b(On)37 b(return)f(the)208 │ │ │ │ │ +TeXDict begin 5 4 bop 83 100 1065 4 v 1231 100 a Fi(Multithreaded)22 │ │ │ │ │ +b Fg(:)37 b Fh(DRAFT)110 b Fg(June)28 b(20,)f(2025)p │ │ │ │ │ +2796 100 V 1065 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 │ │ │ │ │ +(submatrices)f(to)h(threads.)208 689 y(The)j(map)h(from)f(fron)n(ts)g │ │ │ │ │ +(to)h(pro)r(cesses)e(that)i(o)n(wn)f(them)h(is)f(giv)n(en)g(in)h(the)g │ │ │ │ │ +Fi(ownersIV)c Fn(ob)5 b(ject.)64 b(On)37 b(return)f(the)208 │ │ │ │ │ 789 y Fi(cpus[])25 b Fn(v)n(ector)h(is)i(\014lled)f(with)i(the)f(follo) │ │ │ │ │ n(wing.)35 b(The)28 b Fi(stats[])d Fn(v)n(ector)h(is)i(not)f(curren)n │ │ │ │ │ (tly)g(used.)307 951 y Fc(\210)42 b Fi(cpus[0])25 b Fn(|)j(set)f(up)h │ │ │ │ │ (the)g(solv)n(es)307 1080 y Fc(\210)42 b Fi(cpus[1])25 │ │ │ │ │ b Fn(|)j(fetc)n(h)g(righ)n(t)e(hand)i(side)g(and)f(store)g(solution)307 │ │ │ │ │ 1209 y Fc(\210)42 b Fi(cpus[2])25 b Fn(|)j(forw)n(ard)e(solv)n(e)307 │ │ │ │ │ 1338 y Fc(\210)42 b Fi(cpus[3])25 b Fn(|)j(diagonal)e(solv)n(e)307 │ │ │ │ │ @@ -5527,17 +5518,17 @@ │ │ │ │ │ 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 1072 4 v │ │ │ │ │ -1237 w Fi(Multithreaded)22 b Fg(:)37 b Fh(DRAFT)27 b │ │ │ │ │ -Fg(Ma)n(y)g(17,)g(2024)p 2829 100 V 307 390 a Fc(\210)42 │ │ │ │ │ +TeXDict begin 6 5 bop 0 100 a Fn(6)p 125 100 1065 4 v │ │ │ │ │ +1230 w Fi(Multithreaded)23 b Fg(:)37 b Fh(DRAFT)27 b │ │ │ │ │ +Fg(June)g(20,)g(2025)p 2835 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 │ │ │ │ │ @@ -5610,17 +5601,17 @@ │ │ │ │ │ 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 1072 4 v 1237 100 a Fi(Multithreaded)23 │ │ │ │ │ -b Fg(:)36 b Fh(DRAFT)111 b Fg(Ma)n(y)27 b(17,)f(2024)p │ │ │ │ │ -2789 100 V 1072 w Fn(7)307 390 y Fc(\210)42 b Fn(The)32 │ │ │ │ │ +TeXDict begin 7 6 bop 83 100 1065 4 v 1231 100 a Fi(Multithreaded)22 │ │ │ │ │ +b Fg(:)37 b Fh(DRAFT)110 b Fg(June)28 b(20,)f(2025)p │ │ │ │ │ +2796 100 V 1065 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 │ │ │ │ │ @@ -5697,17 +5688,17 @@ │ │ │ │ │ 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 1072 4 v │ │ │ │ │ -1237 w Fi(Multithreaded)22 b Fg(:)37 b Fh(DRAFT)27 b │ │ │ │ │ -Fg(Ma)n(y)g(17,)g(2024)p 2829 100 V 307 390 a Fc(\210)42 │ │ │ │ │ +TeXDict begin 8 7 bop 0 100 a Fn(8)p 125 100 1065 4 v │ │ │ │ │ +1230 w Fi(Multithreaded)23 b Fg(:)37 b Fh(DRAFT)27 b │ │ │ │ │ +Fg(June)g(20,)g(2025)p 2835 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 │ │ │ │ │ @@ -5791,17 +5782,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 1072 4 v 1237 100 a Fi(Multithreaded)23 │ │ │ │ │ -b Fg(:)36 b Fh(DRAFT)111 b Fg(Ma)n(y)27 b(17,)f(2024)p │ │ │ │ │ -2789 100 V 1072 w Fn(9)456 390 y Fa({)41 b Fi(sparsityflag)e(=)k(0)g │ │ │ │ │ +TeXDict begin 9 8 bop 83 100 1065 4 v 1231 100 a Fi(Multithreaded)22 │ │ │ │ │ +b Fg(:)37 b Fh(DRAFT)110 b Fg(June)28 b(20,)f(2025)p │ │ │ │ │ +2796 100 V 1065 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 │ │ │ │ │ @@ -5886,17 +5877,17 @@ │ │ │ │ │ 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 1051 4 │ │ │ │ │ -v 1215 w Fi(Multithreaded)23 b Fg(:)37 b Fh(DRAFT)27 │ │ │ │ │ -b Fg(Ma)n(y)g(17,)g(2024)p 2850 100 V 307 390 a Fc(\210)42 │ │ │ │ │ +TeXDict begin 10 9 bop 0 100 a Fn(10)p 166 100 1045 4 │ │ │ │ │ +v 1209 w Fi(Multithreaded)22 b Fg(:)37 b Fh(DRAFT)28 │ │ │ │ │ +b Fg(June)f(20,)g(2025)p 2856 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 │ │ │ │ │ ├── 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 May 17, 2024 │ │ │ │ │ │ + 2 Multithreaded : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 3 │ │ │ │ │ │ + Multithreaded : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 4 Multithreaded : DRAFT June 20, 2025 │ │ │ │ │ │ • 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 May 17, 2024 5 │ │ │ │ │ │ + Multithreaded : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 6 Multithreaded : DRAFT June 20, 2025 │ │ │ │ │ │ • 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 May 17, 2024 7 │ │ │ │ │ │ + Multithreaded : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 8 Multithreaded : DRAFT June 20, 2025 │ │ │ │ │ │ • 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 May 17, 2024 9 │ │ │ │ │ │ + Multithreaded : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 10 Multithreaded : DRAFT June 20, 2025 │ │ │ │ │ │ • 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 2024.05.17:2218 │ │ │ │ │ +%DVIPSSource: TeX output 2025.06.20:0450 │ │ │ │ │ %%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 │ │ │ │ │ @@ -1541,22 +1541,21 @@ │ │ │ │ │ /UnderlinePosition -100 def │ │ │ │ │ /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 49 /one put │ │ │ │ │ dup 50 /two put │ │ │ │ │ -dup 52 /four put │ │ │ │ │ -dup 55 /seven put │ │ │ │ │ +dup 53 /five put │ │ │ │ │ dup 58 /colon put │ │ │ │ │ -dup 77 /M put │ │ │ │ │ -dup 97 /a put │ │ │ │ │ -dup 121 /y put │ │ │ │ │ +dup 74 /J put │ │ │ │ │ +dup 101 /e put │ │ │ │ │ +dup 110 /n put │ │ │ │ │ +dup 117 /u put │ │ │ │ │ readonly def │ │ │ │ │ currentdict end │ │ │ │ │ currentfile eexec │ │ │ │ │ D9D66F633B846AB284BCF8B0411B772DE5CE32340DC6F28AF40857E4451976E7 │ │ │ │ │ 5182433CF9F333A38BD841C0D4E68BF9E012EB32A8FFB76B5816306B5EDF7C99 │ │ │ │ │ 8B3A16D9B4BC056662E32C7CD0123DFAEB734C7532E64BBFBF5A60336E646716 │ │ │ │ │ EFB852C877F440D329172C71F1E5D59CE9473C26B8AEF7AD68EF0727B6EC2E0C │ │ │ │ │ @@ -1737,72 +1736,64 @@ │ │ │ │ │ 7CA1534C4D5B05FC33F83790ECFD7641DF3FB94289E2A1F6E7D29AB1228A867A │ │ │ │ │ 6E1EF0E9C6F899B491DC18401C2C0A05FFFED46A72C245F7529B8EA55A038082 │ │ │ │ │ 8512307217D2A233C37004085BA3AEE379269F9FA7D0ADB4B19A95CC2AFE686E │ │ │ │ │ 55D88E47257C1FE6F235FEA295910569FE6DD5995512562359CC821E85A6C7A5 │ │ │ │ │ 79B470A9E340A6985189FF8B6AF914A6B0ECF93F47903221F95DE894A8F05B05 │ │ │ │ │ B7D99CD533EC5F931B18E6B39BECF67FA2D6DD1AEC76772B068BE06335A94C05 │ │ │ │ │ 7A4DDEE77B66101DA855C17AC312600370B34E31F5EC3A01300A8EB60B4C9767 │ │ │ │ │ -1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004B9BA1CC │ │ │ │ │ -580D3C6BDA4DC1B80B4365F1C80512453FC5316EC2D928FB731C3D6403E3C18B │ │ │ │ │ -E8424D644DF5E9A2134229C5C91CA68DB8E85BA2BB40F538F585DA6FA4037718 │ │ │ │ │ -B8053EBBA1E765346BCD5BDAA6C38115D31611D8A87A2238C145F2DA2F92E4DF │ │ │ │ │ -3987BD9C4D2A3D460E8941A68B125BCD9EE4F9FD262C4C8A71F47A2C81975635 │ │ │ │ │ -F1B981C274C53FA2ACCDE4C9D0A7C62D6C1EFF91CFC6712CA6A9F333C9564FCB │ │ │ │ │ -2A70F0AD715A79B10A08AB069E2A3C93BC0AED19D0CA10134B8DDDE8AF548DB2 │ │ │ │ │ -3A4AAA9C29682CF135BB767DAA16169A127EB50A7EECEB6480CF56A7D0F8AC56 │ │ │ │ │ -4A5090B3D75A790372886AF568D94C8165975A05BFBFDF1FFBA45F70700BB9E0 │ │ │ │ │ -57F3249EF9E9C8AD9CBCF6E4FD592DC4CDD2CC7C0BC3130C1059096C657BE453 │ │ │ │ │ -A2CBACE93420210E27AF56CA229BD6D982FB68B3FDC6D44478B922C4231C47EE │ │ │ │ │ -E500232F6C11D92DEB955F66DF52B92B22E7352790CC2DCBAC53965D57AC2920 │ │ │ │ │ -68B7D520DE25047146EFEB06B9AD4E2A94243C7E5239F0BC2FC312B16051D52C │ │ │ │ │ -0B92C217B6B42997321AE4F8BB066754B7AA3F15069EF59224E8A442CE471AA7 │ │ │ │ │ -E8049A3DD9EDA09CCEE4998998661CF7DB35E952F6C65DAEB3013951C59F3E09 │ │ │ │ │ -157F313B0237876E1C0190F0473819570B8C0205AADF05D787CC00979CFB327A │ │ │ │ │ -289382B22DDA6F12804ED0ED5B179E36A995A2A59E1B66E75130DBE9109C813B │ │ │ │ │ -94403E0DEA8314A1E9DB474D7FA83C0BAFD08033E6A6215844C1D26BE15F1251 │ │ │ │ │ -A1605E8DF9A9C601ED37379530BC1C82BE5463C6C711C5652BFD6262485AA9CA │ │ │ │ │ -B8C4A117593001D08D980041E2A83C190DCE8E6CD3D334E5CC19FC05DB30F7F7 │ │ │ │ │ -24A305C4DBB31F0651392B99D44B4302333BDF7E326FD256DD75D309C6E73F85 │ │ │ │ │ -FA71B35FD1F9BEFF4C7A1076362EEB0A85492933B6006086A7B8C1928CF2D1EE │ │ │ │ │ -FD4344409257BB802C117E739960821CD3C88BFBA5669FF16F610AD638AF3677 │ │ │ │ │ -8674C985E6767253ED5769F71BEA5E9BB02A751F9E62EE2B18AC19D975FDEAE9 │ │ │ │ │ -8B8822367FF177A7E850766DE99ED3366D46464612926430012212A90F8E85F4 │ │ │ │ │ -4760B40D5B86B90819EE410382C23E86DCAF4F0FF5DFEB2C285965F4DCF2FB2B │ │ │ │ │ -457C0A0427A8D4ADA514E9DACD0F9367E1DA225DB21DA4DDAE33F2B529686D92 │ │ │ │ │ -AC085B345565F9DFFA012FD494DBB2E0B44A0787B2B72DC8D25399DAAE8864B7 │ │ │ │ │ -E84AA99DAFCEAF18F8B41882720316450F1B1CA48B418C9736E5CE4AFF996111 │ │ │ │ │ -5F7FE80958B6A3498508E9693CB134402D92E30D4C2939070D4647E13682290E │ │ │ │ │ -1D0820A3FCA7147157D09D1A40771F214EAE7DD743EA26839E535CA186C05CB8 │ │ │ │ │ -4874988AA1104D85AF0220FE7224344FF624E794BD2454E1C0AC971522FBECBA │ │ │ │ │ -B2497F25CD621B77EC5160973EF5ECC39C183DC051B0DFCB090194A2525BD96E │ │ │ │ │ -28593FDA80D8D259F039416D5F9AF0AD3C9A105B49DAF6E681921E369B7666C6 │ │ │ │ │ -2B73DB37447B00AE96317C2F1C44FB6E6EFD740BAB20FA03A8CE018EC8415582 │ │ │ │ │ -FB06E88A2971E3A480FB1EB4FE93CC7E5179721CAABEE88742B13CF0405F49F4 │ │ │ │ │ -945E587668C821D8C06D6847B6DF84CAFFCD4628670D551FC5F7236875BE1207 │ │ │ │ │ -634BA7F70A19B658FAE7D86F6D00ED28FBF29CC585DEE279325EEF8B0CCB6149 │ │ │ │ │ -E46E638C73D75148F18A636DBC2DD96ED34F68A5A09A3700B1EA34B2D142807C │ │ │ │ │ -F8709D81180783548EAE6F457BF968602076A1069163E3C15BBCEF659C6CF2E6 │ │ │ │ │ -0BB01BDC8E503802CC7969A5B8477E9788C5249B23B19669F5075E089738E49A │ │ │ │ │ -8671D7C1B1B47652F3D78BF2FF74EDB44BA5B092E8D5B85001E97F69D54AEEFC │ │ │ │ │ -88FC3CA1B0D5BAC39263B371005BCFA19AD197A31CC34D0BD55C2CA18C60C485 │ │ │ │ │ -5993F736EF1DD2C5D2B4D50B3D498861B4DF5E7AFF614BBCA4C2E6BECC0DCEF5 │ │ │ │ │ -95F0D686188014C530D8E37650CDCAE721B4AFB0F178BC744BDDDED45DAB7FEB │ │ │ │ │ -A10B975E26099E3DC61116D6BF554574F948895B88EEFE03DCC5351190836AD4 │ │ │ │ │ -EBC1AC55C6D099A8E7B0A372D290C481F44FA464B9C11A0BC991CB045E0AAAC4 │ │ │ │ │ -5C73CA43A4F17D1ADDD33D1B917FF95BFF411C8409F41553B1BC97DE47E3A1F4 │ │ │ │ │ -A5C1D1B7B1BF7E2507AC53956C141411F4F657E37981996DD7BB7ADB2CB6AE01 │ │ │ │ │ -73D0876B8F896F626D5022FE53BA34D5668BD698BE8D5CCAD083CBCEF440BE6A │ │ │ │ │ -8090EB1CDEE5F99C8988650BD4E539B357C31C597D8A9104A9D5967D4E906CAD │ │ │ │ │ -2A65575A884B1C5F6CC509E742FA9DDD66494F219178161AF72C50848E226A95 │ │ │ │ │ -A8C247FF9FF0BABD073021271B5C0692F9BE220071DAB09E5A026629371EE3C4 │ │ │ │ │ -A6E4FA94625D87A5B66EF077ED54C72B1052AEAA9637B30C76EF8EB04AD5F476 │ │ │ │ │ -D15F1C93C0BC6E0F67B366097BBED03FE82C040F9EF02866159B46854E11D44F │ │ │ │ │ -54AE6748A7E61B993A4EECD3B8BE3B5897A66BBCDFE24F65BC2AD5AB49048CF1 │ │ │ │ │ -647203823F84DF5CB483096F9D96AEE3A2855E479B72A14A67C633CE99C101CF │ │ │ │ │ -EFAE939BF9B02E710D │ │ │ │ │ +1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004ACD1870 │ │ │ │ │ +A5EA947858F5795870BFE1343AD803FB854BF8F5A4E794E8EC57BE41DB5B8734 │ │ │ │ │ +13E47950F29A81EA0C81EA798863883D7F41F78325CA190CBBFFE822AE494550 │ │ │ │ │ +4BE83703071FC9512D128927AF3F63CEF8F86ABE1E15D7B4DDD39576E7DFF45E │ │ │ │ │ +3CB4115AAB1830DE8647B915DB4BEBEB5235C281E098B899BAB951D8D5798F01 │ │ │ │ │ +7F7C47336D31438E5126738AFEAB29E9A7CBE06DE4DD604477B542D2620DFD58 │ │ │ │ │ +28FE34238572F23C5A8EB7ACEE1E154DA13FC1A5AA67A3BA8C5CDFB2B80312C9 │ │ │ │ │ +BC9FAE56D08DDFA9498E6EF0D0F6BD18B3923E0B670B0740528BC843610736CB │ │ │ │ │ +80228C105C2F72C3C22D610C3D8C268DEEA2AEEE3221E198E79FE2966487360C │ │ │ │ │ +84AE08AC326F48B21447652121B1EB68AF856055EEA65B6B625BF622CBFC2D1C │ │ │ │ │ +EF943CC4CAF2C715782C9EF9A9BA4689BFC6B6A82F8D55795BE8111E2C7DE520 │ │ │ │ │ +367362304B6A48186C842033E715A46265A352472F4F7313248EBCD26BEA97E7 │ │ │ │ │ +B814A61D4B7ADCB5C5F21AA34E0C1269E8426DBFB511DE6E26B960456C8F8520 │ │ │ │ │ +5F0DD382289A62AF0B935EDB5B2394538C5F0EE72962D2F98F3C38CD7C027B9F │ │ │ │ │ +E230E67E40FEFBDED06B3423C9DFD669E6B5BC913E0FF75786A64A6C11D4FE89 │ │ │ │ │ +1B918DC0E953C52CFD153063CD0D2A78B43F8712243845E6F2CBA1DB610F403D │ │ │ │ │ +A98D06D95FF44C7AC029092B666A8B0DCEA95B34F5ACC10E8611BADE6A24469C │ │ │ │ │ +0C01D95BFB445FA22CD38D033E4D24E006BB9D54EE41EF7AD5AC9C299721F61A │ │ │ │ │ +F01B6EDCDF428BD9195A13C5B1027358F8A203F828A1DD9622243B2D76C6F1BA │ │ │ │ │ +9F2D7E9D4879FC668ABC750CD25415DC6CCF2257C28F78D3F9BE499CC0FF2F80 │ │ │ │ │ +2C2CD1DEFABD6668FCA76E1D629A344333E33DA24B86D2E9F8F5EE1C29974640 │ │ │ │ │ +C3E78E999BAB313400041DADDDFDBFFCC419F129A84F4D412B79E8BE4511CA00 │ │ │ │ │ +F92A4F3CDD2E51345D3965C104F06B6503445DC20224CB7606A9D7D5F9EE45E6 │ │ │ │ │ +1B2963DA96AA2AB1BA5BE29656E666E4D0E122DE58EEA68E04ED76438DA03E65 │ │ │ │ │ +B80055A86B7B2A26BAE6BBB8835E17F9696E9B3CD34571BA75C76D4D2CCC48F1 │ │ │ │ │ +7534C1EF9127E374D65D05B8072E08D6C72A0B4A35EA0DD717743C66D105CCD8 │ │ │ │ │ +7355F13E9C38C1A4351624E689ED7909100942FA0474842EE44DEC3279E1A1CD │ │ │ │ │ +8064666EB845CA7C3E906B67C0BF96A28D514DB2E4A1E4AF287350B03762A2CF │ │ │ │ │ +13B18AC3F5D2F3B74A1D50267C03EFB74B888E1D24ABEEA4A885F4D0BF14C0D8 │ │ │ │ │ +289AC79D6D98E2A2C831672FB1F3457564CD161ADC3AF610D88201AB5B0C10CB │ │ │ │ │ +5ECCC2D5C4AF39C8CB3044BF9EC791BA45D29C2B51EA0483D19822C264CE6FA3 │ │ │ │ │ +5C97F2DF5A78CB93528E99B9ED7CB121C83130C129B849B52A36EBD88AF19DD3 │ │ │ │ │ +C5CABE831027388EF86BD5CBD90AAAC089775938A321C44D4DDA67A51312D8AB │ │ │ │ │ +C509DDBE7044A107AB2BE9C4C9556F85C529B174A7778B489BF28EC07A834542 │ │ │ │ │ +8B31F2925C21FB2096877711F998763D5A8495002B8E080AF8DBB1B3106EDDBA │ │ │ │ │ +35121D52E0846A7AF3ABEDF87BDE4FA665673A9B80CA538B98F873947AA17EF4 │ │ │ │ │ +9BB182917E9D79BC7EC681E93710D6A1D6B0E4A7FA9452FC1C431808174F3AB7 │ │ │ │ │ +F3914FBC86CB34E8583457243C3C7BE4BC166C7397689BC6FFB82EA2967E88EE │ │ │ │ │ +464F96EDA144DE2B64401B8E577ABCA2D826FE0B92E21FFAE3E81EBB6B6EB36E │ │ │ │ │ +9B1A8FE3884CA398C03135FD49D51724FC1268E9482E41FAEA2FC6C809006B8F │ │ │ │ │ +5D4F9E038450AD3A6041C16FD1C7E5FC80C0E033CE57E64863E014531D94DF1E │ │ │ │ │ +31D7D038AFCB60715AA73C1E96F113A24C5AF35BBEB61C4D079ED034ED83AA4A │ │ │ │ │ +E12448E618330463304788BCF40561CD63167B3BF144F408E2B89E60B8BA13EF │ │ │ │ │ +3B57D286FD23D4FA8BAEFF98DC1188B1982956CC1DCAEFC7D949B7B4E3BE8F8A │ │ │ │ │ +BFE2C9D938DD13EFEE7123576608D9396F260907DA98AE2D3DD5822306CBC8A6 │ │ │ │ │ +B083C697DDA3C62EE7879436A9FD8EE0034B105105B3F122F893EA2126EBE8A9 │ │ │ │ │ +5CBF2BD248DD9FBEF0040C25797BD13B69A8C9F0D4E4F935C61ED30487CCDB1A │ │ │ │ │ +0339006E78EE1755929D2412776EC7DB1F666DBDD28EA8AC7397F809C7F38A41 │ │ │ │ │ +5B3BF6C75F4F35C90141EB08377AF452CF840FEA938805F9D14E02DC29215B4E │ │ │ │ │ +F1EB │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ @@ -4664,19 +4655,19 @@ │ │ │ │ │ 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 23[45 19[83 18[25 2[45 2[45 1[45 45 45 3[25 │ │ │ │ │ -44[{}10 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 │ │ │ │ │ +/Fe 138[51 6[51 8[40 26[47 15[25 4[45 2[45 1[45 3[25 │ │ │ │ │ +44[{}9 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 │ │ │ │ │ /afii61664.cap/arrowleft/arrowright/tieaccentlowercase/tieaccentcapital │ │ │ │ │ /tieaccentlowercase.new/tieaccentcapital.new/.notdef/afii61664.asc/uni2422 3 │ │ │ │ │ {/.notdef}repeat/dollar/.notdef/.notdef/quotesingle/.notdef/.notdef │ │ │ │ │ @@ -4805,17 +4796,17 @@ │ │ │ │ │ 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 1131 4 v │ │ │ │ │ -1313 w Fm(Network)29 b Fe(:)40 b Fd(DRAFT)30 b Fe(Ma)m(y)i(17,)f(2024)p │ │ │ │ │ -2769 100 V 137 399 a Fj(\210)45 b Fn(An)33 b(edge)g(\()p │ │ │ │ │ +TeXDict begin 2 1 bop 0 100 a Fn(2)p 136 100 1124 4 v │ │ │ │ │ +1306 w Fm(Network)29 b Fe(:)40 b Fd(DRAFT)30 b Fe(June)g(20,)h(2025)p │ │ │ │ │ +2776 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 │ │ │ │ │ @@ -4890,17 +4881,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 1131 4 v 1313 100 a Fm(Network)28 │ │ │ │ │ -b Fe(:)41 b Fd(DRAFT)121 b Fe(Ma)m(y)31 b(17,)h(2024)p │ │ │ │ │ -2722 100 V 1131 w Fn(3)137 399 y Fj(\210)45 b Fm(int)i(narc)29 │ │ │ │ │ +TeXDict begin 3 2 bop 91 100 1124 4 v 1306 100 a Fm(Network)28 │ │ │ │ │ +b Fe(:)41 b Fd(DRAFT)121 b Fe(June)29 b(20,)j(2025)p │ │ │ │ │ +2729 100 V 1124 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 │ │ │ │ │ @@ -4945,17 +4936,17 @@ │ │ │ │ │ (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 1131 4 v │ │ │ │ │ -1313 w Fm(Network)29 b Fe(:)40 b Fd(DRAFT)30 b Fe(Ma)m(y)i(17,)f(2024)p │ │ │ │ │ -2769 100 V 0 399 a Fa(1.2.1)112 b(Basic)38 b(metho)s(ds)0 │ │ │ │ │ +TeXDict begin 4 3 bop 0 100 a Fn(4)p 136 100 1124 4 v │ │ │ │ │ +1306 w Fm(Network)29 b Fe(:)40 b Fd(DRAFT)30 b Fe(June)g(20,)h(2025)p │ │ │ │ │ +2776 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 │ │ │ │ │ @@ -5018,17 +5009,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 1131 4 v 1313 100 a Fm(Network)28 │ │ │ │ │ -b Fe(:)41 b Fd(DRAFT)121 b Fe(Ma)m(y)31 b(17,)h(2024)p │ │ │ │ │ -2722 100 V 1131 w Fn(5)0 399 y Fa(1.2.3)112 b(Utilit)m(y)38 │ │ │ │ │ +TeXDict begin 5 4 bop 91 100 1124 4 v 1306 100 a Fm(Network)28 │ │ │ │ │ +b Fe(:)41 b Fd(DRAFT)121 b Fe(June)29 b(20,)j(2025)p │ │ │ │ │ +2729 100 V 1124 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 │ │ │ │ │ @@ -5102,17 +5093,17 @@ │ │ │ │ │ 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 1131 4 v │ │ │ │ │ -1313 w Fm(Network)29 b Fe(:)40 b Fd(DRAFT)30 b Fe(Ma)m(y)i(17,)f(2024)p │ │ │ │ │ -2769 100 V 0 399 a Fa(1.2.4)112 b(IO)38 b(metho)s(ds)0 │ │ │ │ │ +TeXDict begin 6 5 bop 0 100 a Fn(6)p 136 100 1124 4 v │ │ │ │ │ +1306 w Fm(Network)29 b Fe(:)40 b Fd(DRAFT)30 b Fe(June)g(20,)h(2025)p │ │ │ │ │ +2776 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 │ │ │ │ │ ├── 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 May 17, 2024 │ │ │ │ │ │ + 2 Network : DRAFT June 20, 2025 │ │ │ │ │ │ • 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 May 17, 2024 3 │ │ │ │ │ │ + Network : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 4 Network : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 5 │ │ │ │ │ │ + Network : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 6 Network : DRAFT June 20, 2025 │ │ │ │ │ │ 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 2024.05.17:2218 │ │ │ │ │ +%DVIPSSource: TeX output 2025.06.20:0450 │ │ │ │ │ %%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 │ │ │ │ │ @@ -2039,22 +2039,21 @@ │ │ │ │ │ /UnderlinePosition -100 def │ │ │ │ │ /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 49 /one put │ │ │ │ │ dup 50 /two put │ │ │ │ │ -dup 52 /four put │ │ │ │ │ -dup 55 /seven put │ │ │ │ │ +dup 53 /five put │ │ │ │ │ dup 58 /colon put │ │ │ │ │ -dup 77 /M put │ │ │ │ │ -dup 97 /a put │ │ │ │ │ -dup 121 /y put │ │ │ │ │ +dup 74 /J put │ │ │ │ │ +dup 101 /e put │ │ │ │ │ +dup 110 /n put │ │ │ │ │ +dup 117 /u put │ │ │ │ │ readonly def │ │ │ │ │ currentdict end │ │ │ │ │ currentfile eexec │ │ │ │ │ D9D66F633B846AB284BCF8B0411B772DE5CE32340DC6F28AF40857E4451976E7 │ │ │ │ │ 5182433CF9F333A38BD841C0D4E68BF9E012EB32A8FFB76B5816306B5EDF7C99 │ │ │ │ │ 8B3A16D9B4BC056662E32C7CD0123DFAEB734C7532E64BBFBF5A60336E646716 │ │ │ │ │ EFB852C877F440D329172C71F1E5D59CE9473C26B8AEF7AD68EF0727B6EC2E0C │ │ │ │ │ @@ -2235,72 +2234,64 @@ │ │ │ │ │ 7CA1534C4D5B05FC33F83790ECFD7641DF3FB94289E2A1F6E7D29AB1228A867A │ │ │ │ │ 6E1EF0E9C6F899B491DC18401C2C0A05FFFED46A72C245F7529B8EA55A038082 │ │ │ │ │ 8512307217D2A233C37004085BA3AEE379269F9FA7D0ADB4B19A95CC2AFE686E │ │ │ │ │ 55D88E47257C1FE6F235FEA295910569FE6DD5995512562359CC821E85A6C7A5 │ │ │ │ │ 79B470A9E340A6985189FF8B6AF914A6B0ECF93F47903221F95DE894A8F05B05 │ │ │ │ │ B7D99CD533EC5F931B18E6B39BECF67FA2D6DD1AEC76772B068BE06335A94C05 │ │ │ │ │ 7A4DDEE77B66101DA855C17AC312600370B34E31F5EC3A01300A8EB60B4C9767 │ │ │ │ │ -1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004B9BA1CC │ │ │ │ │ -580D3C6BDA4DC1B80B4365F1C80512453FC5316EC2D928FB731C3D6403E3C18B │ │ │ │ │ -E8424D644DF5E9A2134229C5C91CA68DB8E85BA2BB40F538F585DA6FA4037718 │ │ │ │ │ -B8053EBBA1E765346BCD5BDAA6C38115D31611D8A87A2238C145F2DA2F92E4DF │ │ │ │ │ -3987BD9C4D2A3D460E8941A68B125BCD9EE4F9FD262C4C8A71F47A2C81975635 │ │ │ │ │ -F1B981C274C53FA2ACCDE4C9D0A7C62D6C1EFF91CFC6712CA6A9F333C9564FCB │ │ │ │ │ -2A70F0AD715A79B10A08AB069E2A3C93BC0AED19D0CA10134B8DDDE8AF548DB2 │ │ │ │ │ -3A4AAA9C29682CF135BB767DAA16169A127EB50A7EECEB6480CF56A7D0F8AC56 │ │ │ │ │ -4A5090B3D75A790372886AF568D94C8165975A05BFBFDF1FFBA45F70700BB9E0 │ │ │ │ │ -57F3249EF9E9C8AD9CBCF6E4FD592DC4CDD2CC7C0BC3130C1059096C657BE453 │ │ │ │ │ -A2CBACE93420210E27AF56CA229BD6D982FB68B3FDC6D44478B922C4231C47EE │ │ │ │ │ -E500232F6C11D92DEB955F66DF52B92B22E7352790CC2DCBAC53965D57AC2920 │ │ │ │ │ -68B7D520DE25047146EFEB06B9AD4E2A94243C7E5239F0BC2FC312B16051D52C │ │ │ │ │ -0B92C217B6B42997321AE4F8BB066754B7AA3F15069EF59224E8A442CE471AA7 │ │ │ │ │ -E8049A3DD9EDA09CCEE4998998661CF7DB35E952F6C65DAEB3013951C59F3E09 │ │ │ │ │ -157F313B0237876E1C0190F0473819570B8C0205AADF05D787CC00979CFB327A │ │ │ │ │ -289382B22DDA6F12804ED0ED5B179E36A995A2A59E1B66E75130DBE9109C813B │ │ │ │ │ -94403E0DEA8314A1E9DB474D7FA83C0BAFD08033E6A6215844C1D26BE15F1251 │ │ │ │ │ -A1605E8DF9A9C601ED37379530BC1C82BE5463C6C711C5652BFD6262485AA9CA │ │ │ │ │ -B8C4A117593001D08D980041E2A83C190DCE8E6CD3D334E5CC19FC05DB30F7F7 │ │ │ │ │ -24A305C4DBB31F0651392B99D44B4302333BDF7E326FD256DD75D309C6E73F85 │ │ │ │ │ -FA71B35FD1F9BEFF4C7A1076362EEB0A85492933B6006086A7B8C1928CF2D1EE │ │ │ │ │ -FD4344409257BB802C117E739960821CD3C88BFBA5669FF16F610AD638AF3677 │ │ │ │ │ -8674C985E6767253ED5769F71BEA5E9BB02A751F9E62EE2B18AC19D975FDEAE9 │ │ │ │ │ -8B8822367FF177A7E850766DE99ED3366D46464612926430012212A90F8E85F4 │ │ │ │ │ -4760B40D5B86B90819EE410382C23E86DCAF4F0FF5DFEB2C285965F4DCF2FB2B │ │ │ │ │ -457C0A0427A8D4ADA514E9DACD0F9367E1DA225DB21DA4DDAE33F2B529686D92 │ │ │ │ │ -AC085B345565F9DFFA012FD494DBB2E0B44A0787B2B72DC8D25399DAAE8864B7 │ │ │ │ │ -E84AA99DAFCEAF18F8B41882720316450F1B1CA48B418C9736E5CE4AFF996111 │ │ │ │ │ -5F7FE80958B6A3498508E9693CB134402D92E30D4C2939070D4647E13682290E │ │ │ │ │ -1D0820A3FCA7147157D09D1A40771F214EAE7DD743EA26839E535CA186C05CB8 │ │ │ │ │ -4874988AA1104D85AF0220FE7224344FF624E794BD2454E1C0AC971522FBECBA │ │ │ │ │ -B2497F25CD621B77EC5160973EF5ECC39C183DC051B0DFCB090194A2525BD96E │ │ │ │ │ -28593FDA80D8D259F039416D5F9AF0AD3C9A105B49DAF6E681921E369B7666C6 │ │ │ │ │ -2B73DB37447B00AE96317C2F1C44FB6E6EFD740BAB20FA03A8CE018EC8415582 │ │ │ │ │ -FB06E88A2971E3A480FB1EB4FE93CC7E5179721CAABEE88742B13CF0405F49F4 │ │ │ │ │ -945E587668C821D8C06D6847B6DF84CAFFCD4628670D551FC5F7236875BE1207 │ │ │ │ │ -634BA7F70A19B658FAE7D86F6D00ED28FBF29CC585DEE279325EEF8B0CCB6149 │ │ │ │ │ -E46E638C73D75148F18A636DBC2DD96ED34F68A5A09A3700B1EA34B2D142807C │ │ │ │ │ -F8709D81180783548EAE6F457BF968602076A1069163E3C15BBCEF659C6CF2E6 │ │ │ │ │ -0BB01BDC8E503802CC7969A5B8477E9788C5249B23B19669F5075E089738E49A │ │ │ │ │ -8671D7C1B1B47652F3D78BF2FF74EDB44BA5B092E8D5B85001E97F69D54AEEFC │ │ │ │ │ -88FC3CA1B0D5BAC39263B371005BCFA19AD197A31CC34D0BD55C2CA18C60C485 │ │ │ │ │ -5993F736EF1DD2C5D2B4D50B3D498861B4DF5E7AFF614BBCA4C2E6BECC0DCEF5 │ │ │ │ │ -95F0D686188014C530D8E37650CDCAE721B4AFB0F178BC744BDDDED45DAB7FEB │ │ │ │ │ -A10B975E26099E3DC61116D6BF554574F948895B88EEFE03DCC5351190836AD4 │ │ │ │ │ -EBC1AC55C6D099A8E7B0A372D290C481F44FA464B9C11A0BC991CB045E0AAAC4 │ │ │ │ │ -5C73CA43A4F17D1ADDD33D1B917FF95BFF411C8409F41553B1BC97DE47E3A1F4 │ │ │ │ │ -A5C1D1B7B1BF7E2507AC53956C141411F4F657E37981996DD7BB7ADB2CB6AE01 │ │ │ │ │ -73D0876B8F896F626D5022FE53BA34D5668BD698BE8D5CCAD083CBCEF440BE6A │ │ │ │ │ -8090EB1CDEE5F99C8988650BD4E539B357C31C597D8A9104A9D5967D4E906CAD │ │ │ │ │ -2A65575A884B1C5F6CC509E742FA9DDD66494F219178161AF72C50848E226A95 │ │ │ │ │ -A8C247FF9FF0BABD073021271B5C0692F9BE220071DAB09E5A026629371EE3C4 │ │ │ │ │ -A6E4FA94625D87A5B66EF077ED54C72B1052AEAA9637B30C76EF8EB04AD5F476 │ │ │ │ │ -D15F1C93C0BC6E0F67B366097BBED03FE82C040F9EF02866159B46854E11D44F │ │ │ │ │ -54AE6748A7E61B993A4EECD3B8BE3B5897A66BBCDFE24F65BC2AD5AB49048CF1 │ │ │ │ │ -647203823F84DF5CB483096F9D96AEE3A2855E479B72A14A67C633CE99C101CF │ │ │ │ │ -EFAE939BF9B02E710D │ │ │ │ │ +1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004ACD1870 │ │ │ │ │ +A5EA947858F5795870BFE1343AD803FB854BF8F5A4E794E8EC57BE41DB5B8734 │ │ │ │ │ +13E47950F29A81EA0C81EA798863883D7F41F78325CA190CBBFFE822AE494550 │ │ │ │ │ +4BE83703071FC9512D128927AF3F63CEF8F86ABE1E15D7B4DDD39576E7DFF45E │ │ │ │ │ +3CB4115AAB1830DE8647B915DB4BEBEB5235C281E098B899BAB951D8D5798F01 │ │ │ │ │ +7F7C47336D31438E5126738AFEAB29E9A7CBE06DE4DD604477B542D2620DFD58 │ │ │ │ │ +28FE34238572F23C5A8EB7ACEE1E154DA13FC1A5AA67A3BA8C5CDFB2B80312C9 │ │ │ │ │ +BC9FAE56D08DDFA9498E6EF0D0F6BD18B3923E0B670B0740528BC843610736CB │ │ │ │ │ +80228C105C2F72C3C22D610C3D8C268DEEA2AEEE3221E198E79FE2966487360C │ │ │ │ │ +84AE08AC326F48B21447652121B1EB68AF856055EEA65B6B625BF622CBFC2D1C │ │ │ │ │ +EF943CC4CAF2C715782C9EF9A9BA4689BFC6B6A82F8D55795BE8111E2C7DE520 │ │ │ │ │ +367362304B6A48186C842033E715A46265A352472F4F7313248EBCD26BEA97E7 │ │ │ │ │ +B814A61D4B7ADCB5C5F21AA34E0C1269E8426DBFB511DE6E26B960456C8F8520 │ │ │ │ │ +5F0DD382289A62AF0B935EDB5B2394538C5F0EE72962D2F98F3C38CD7C027B9F │ │ │ │ │ +E230E67E40FEFBDED06B3423C9DFD669E6B5BC913E0FF75786A64A6C11D4FE89 │ │ │ │ │ +1B918DC0E953C52CFD153063CD0D2A78B43F8712243845E6F2CBA1DB610F403D │ │ │ │ │ +A98D06D95FF44C7AC029092B666A8B0DCEA95B34F5ACC10E8611BADE6A24469C │ │ │ │ │ +0C01D95BFB445FA22CD38D033E4D24E006BB9D54EE41EF7AD5AC9C299721F61A │ │ │ │ │ +F01B6EDCDF428BD9195A13C5B1027358F8A203F828A1DD9622243B2D76C6F1BA │ │ │ │ │ +9F2D7E9D4879FC668ABC750CD25415DC6CCF2257C28F78D3F9BE499CC0FF2F80 │ │ │ │ │ +2C2CD1DEFABD6668FCA76E1D629A344333E33DA24B86D2E9F8F5EE1C29974640 │ │ │ │ │ +C3E78E999BAB313400041DADDDFDBFFCC419F129A84F4D412B79E8BE4511CA00 │ │ │ │ │ +F92A4F3CDD2E51345D3965C104F06B6503445DC20224CB7606A9D7D5F9EE45E6 │ │ │ │ │ +1B2963DA96AA2AB1BA5BE29656E666E4D0E122DE58EEA68E04ED76438DA03E65 │ │ │ │ │ +B80055A86B7B2A26BAE6BBB8835E17F9696E9B3CD34571BA75C76D4D2CCC48F1 │ │ │ │ │ +7534C1EF9127E374D65D05B8072E08D6C72A0B4A35EA0DD717743C66D105CCD8 │ │ │ │ │ +7355F13E9C38C1A4351624E689ED7909100942FA0474842EE44DEC3279E1A1CD │ │ │ │ │ +8064666EB845CA7C3E906B67C0BF96A28D514DB2E4A1E4AF287350B03762A2CF │ │ │ │ │ +13B18AC3F5D2F3B74A1D50267C03EFB74B888E1D24ABEEA4A885F4D0BF14C0D8 │ │ │ │ │ +289AC79D6D98E2A2C831672FB1F3457564CD161ADC3AF610D88201AB5B0C10CB │ │ │ │ │ +5ECCC2D5C4AF39C8CB3044BF9EC791BA45D29C2B51EA0483D19822C264CE6FA3 │ │ │ │ │ +5C97F2DF5A78CB93528E99B9ED7CB121C83130C129B849B52A36EBD88AF19DD3 │ │ │ │ │ +C5CABE831027388EF86BD5CBD90AAAC089775938A321C44D4DDA67A51312D8AB │ │ │ │ │ +C509DDBE7044A107AB2BE9C4C9556F85C529B174A7778B489BF28EC07A834542 │ │ │ │ │ +8B31F2925C21FB2096877711F998763D5A8495002B8E080AF8DBB1B3106EDDBA │ │ │ │ │ +35121D52E0846A7AF3ABEDF87BDE4FA665673A9B80CA538B98F873947AA17EF4 │ │ │ │ │ +9BB182917E9D79BC7EC681E93710D6A1D6B0E4A7FA9452FC1C431808174F3AB7 │ │ │ │ │ +F3914FBC86CB34E8583457243C3C7BE4BC166C7397689BC6FFB82EA2967E88EE │ │ │ │ │ +464F96EDA144DE2B64401B8E577ABCA2D826FE0B92E21FFAE3E81EBB6B6EB36E │ │ │ │ │ +9B1A8FE3884CA398C03135FD49D51724FC1268E9482E41FAEA2FC6C809006B8F │ │ │ │ │ +5D4F9E038450AD3A6041C16FD1C7E5FC80C0E033CE57E64863E014531D94DF1E │ │ │ │ │ +31D7D038AFCB60715AA73C1E96F113A24C5AF35BBEB61C4D079ED034ED83AA4A │ │ │ │ │ +E12448E618330463304788BCF40561CD63167B3BF144F408E2B89E60B8BA13EF │ │ │ │ │ +3B57D286FD23D4FA8BAEFF98DC1188B1982956CC1DCAEFC7D949B7B4E3BE8F8A │ │ │ │ │ +BFE2C9D938DD13EFEE7123576608D9396F260907DA98AE2D3DD5822306CBC8A6 │ │ │ │ │ +B083C697DDA3C62EE7879436A9FD8EE0034B105105B3F122F893EA2126EBE8A9 │ │ │ │ │ +5CBF2BD248DD9FBEF0040C25797BD13B69A8C9F0D4E4F935C61ED30487CCDB1A │ │ │ │ │ +0339006E78EE1755929D2412776EC7DB1F666DBDD28EA8AC7397F809C7F38A41 │ │ │ │ │ +5B3BF6C75F4F35C90141EB08377AF452CF840FEA938805F9D14E02DC29215B4E │ │ │ │ │ +F1EB │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ @@ -4756,16 +4747,16 @@ │ │ │ │ │ rf /Fb 139[62 4[62 62 5[62 1[62 1[62 62 1[62 16[62 6[62 │ │ │ │ │ 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 23[45 19[83 │ │ │ │ │ -18[25 2[45 2[45 1[45 45 45 3[25 44[{}10 90.9091 /CMSL10 │ │ │ │ │ +6[28 58[{}16 90.9091 /CMTI10 rf /Fg 138[51 6[51 8[40 │ │ │ │ │ +26[47 15[25 4[45 2[45 1[45 3[25 44[{}9 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 │ │ │ │ │ @@ -4895,18 +4886,18 @@ │ │ │ │ │ (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 964 4 v │ │ │ │ │ -1146 w Fn(PatchAndGoInfo)27 b Fg(:)40 b Ff(DRAFT)30 b │ │ │ │ │ -Fg(Ma)m(y)i(17,)f(2024)p 2936 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 │ │ │ │ │ +TeXDict begin 2 1 bop 0 100 a Fo(2)p 136 100 957 4 v │ │ │ │ │ +1139 w Fn(PatchAndGoInfo)27 b Fg(:)40 b Ff(DRAFT)31 b │ │ │ │ │ +Fg(June)e(20,)i(2025)p 2943 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 │ │ │ │ │ @@ -4959,17 +4950,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 964 4 v 1146 100 a Fn(PatchAndGoInfo)26 │ │ │ │ │ -b Fg(:)41 b Ff(DRAFT)121 b Fg(Ma)m(y)31 b(17,)h(2024)p │ │ │ │ │ -2889 100 V 964 w Fo(3)111 399 y(3.)46 b Fn(void)h │ │ │ │ │ +TeXDict begin 3 2 bop 91 100 957 4 v 1139 100 a Fn(PatchAndGoInfo)26 │ │ │ │ │ +b Fg(:)41 b Ff(DRAFT)121 b Fg(June)29 b(20,)j(2025)p │ │ │ │ │ +2896 100 V 957 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 May 17, 2024 │ │ │ │ │ │ + 2 PatchAndGoInfo : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 3 │ │ │ │ │ │ + PatchAndGoInfo : DRAFT June 20, 2025 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 2024.05.17:2218 │ │ │ │ │ +%DVIPSSource: TeX output 2025.06.20:0450 │ │ │ │ │ %%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 │ │ │ │ │ @@ -1880,22 +1880,21 @@ │ │ │ │ │ /UnderlinePosition -100 def │ │ │ │ │ /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 49 /one put │ │ │ │ │ dup 50 /two put │ │ │ │ │ -dup 52 /four put │ │ │ │ │ -dup 55 /seven put │ │ │ │ │ +dup 53 /five put │ │ │ │ │ dup 58 /colon put │ │ │ │ │ -dup 77 /M put │ │ │ │ │ -dup 97 /a put │ │ │ │ │ -dup 121 /y put │ │ │ │ │ +dup 74 /J put │ │ │ │ │ +dup 101 /e put │ │ │ │ │ +dup 110 /n put │ │ │ │ │ +dup 117 /u put │ │ │ │ │ readonly def │ │ │ │ │ currentdict end │ │ │ │ │ currentfile eexec │ │ │ │ │ D9D66F633B846AB284BCF8B0411B772DE5CE32340DC6F28AF40857E4451976E7 │ │ │ │ │ 5182433CF9F333A38BD841C0D4E68BF9E012EB32A8FFB76B5816306B5EDF7C99 │ │ │ │ │ 8B3A16D9B4BC056662E32C7CD0123DFAEB734C7532E64BBFBF5A60336E646716 │ │ │ │ │ EFB852C877F440D329172C71F1E5D59CE9473C26B8AEF7AD68EF0727B6EC2E0C │ │ │ │ │ @@ -2076,72 +2075,64 @@ │ │ │ │ │ 7CA1534C4D5B05FC33F83790ECFD7641DF3FB94289E2A1F6E7D29AB1228A867A │ │ │ │ │ 6E1EF0E9C6F899B491DC18401C2C0A05FFFED46A72C245F7529B8EA55A038082 │ │ │ │ │ 8512307217D2A233C37004085BA3AEE379269F9FA7D0ADB4B19A95CC2AFE686E │ │ │ │ │ 55D88E47257C1FE6F235FEA295910569FE6DD5995512562359CC821E85A6C7A5 │ │ │ │ │ 79B470A9E340A6985189FF8B6AF914A6B0ECF93F47903221F95DE894A8F05B05 │ │ │ │ │ B7D99CD533EC5F931B18E6B39BECF67FA2D6DD1AEC76772B068BE06335A94C05 │ │ │ │ │ 7A4DDEE77B66101DA855C17AC312600370B34E31F5EC3A01300A8EB60B4C9767 │ │ │ │ │ -1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004B9BA1CC │ │ │ │ │ -580D3C6BDA4DC1B80B4365F1C80512453FC5316EC2D928FB731C3D6403E3C18B │ │ │ │ │ -E8424D644DF5E9A2134229C5C91CA68DB8E85BA2BB40F538F585DA6FA4037718 │ │ │ │ │ -B8053EBBA1E765346BCD5BDAA6C38115D31611D8A87A2238C145F2DA2F92E4DF │ │ │ │ │ -3987BD9C4D2A3D460E8941A68B125BCD9EE4F9FD262C4C8A71F47A2C81975635 │ │ │ │ │ -F1B981C274C53FA2ACCDE4C9D0A7C62D6C1EFF91CFC6712CA6A9F333C9564FCB │ │ │ │ │ -2A70F0AD715A79B10A08AB069E2A3C93BC0AED19D0CA10134B8DDDE8AF548DB2 │ │ │ │ │ -3A4AAA9C29682CF135BB767DAA16169A127EB50A7EECEB6480CF56A7D0F8AC56 │ │ │ │ │ -4A5090B3D75A790372886AF568D94C8165975A05BFBFDF1FFBA45F70700BB9E0 │ │ │ │ │ -57F3249EF9E9C8AD9CBCF6E4FD592DC4CDD2CC7C0BC3130C1059096C657BE453 │ │ │ │ │ -A2CBACE93420210E27AF56CA229BD6D982FB68B3FDC6D44478B922C4231C47EE │ │ │ │ │ -E500232F6C11D92DEB955F66DF52B92B22E7352790CC2DCBAC53965D57AC2920 │ │ │ │ │ -68B7D520DE25047146EFEB06B9AD4E2A94243C7E5239F0BC2FC312B16051D52C │ │ │ │ │ -0B92C217B6B42997321AE4F8BB066754B7AA3F15069EF59224E8A442CE471AA7 │ │ │ │ │ -E8049A3DD9EDA09CCEE4998998661CF7DB35E952F6C65DAEB3013951C59F3E09 │ │ │ │ │ -157F313B0237876E1C0190F0473819570B8C0205AADF05D787CC00979CFB327A │ │ │ │ │ -289382B22DDA6F12804ED0ED5B179E36A995A2A59E1B66E75130DBE9109C813B │ │ │ │ │ -94403E0DEA8314A1E9DB474D7FA83C0BAFD08033E6A6215844C1D26BE15F1251 │ │ │ │ │ -A1605E8DF9A9C601ED37379530BC1C82BE5463C6C711C5652BFD6262485AA9CA │ │ │ │ │ -B8C4A117593001D08D980041E2A83C190DCE8E6CD3D334E5CC19FC05DB30F7F7 │ │ │ │ │ -24A305C4DBB31F0651392B99D44B4302333BDF7E326FD256DD75D309C6E73F85 │ │ │ │ │ -FA71B35FD1F9BEFF4C7A1076362EEB0A85492933B6006086A7B8C1928CF2D1EE │ │ │ │ │ -FD4344409257BB802C117E739960821CD3C88BFBA5669FF16F610AD638AF3677 │ │ │ │ │ -8674C985E6767253ED5769F71BEA5E9BB02A751F9E62EE2B18AC19D975FDEAE9 │ │ │ │ │ -8B8822367FF177A7E850766DE99ED3366D46464612926430012212A90F8E85F4 │ │ │ │ │ -4760B40D5B86B90819EE410382C23E86DCAF4F0FF5DFEB2C285965F4DCF2FB2B │ │ │ │ │ -457C0A0427A8D4ADA514E9DACD0F9367E1DA225DB21DA4DDAE33F2B529686D92 │ │ │ │ │ -AC085B345565F9DFFA012FD494DBB2E0B44A0787B2B72DC8D25399DAAE8864B7 │ │ │ │ │ -E84AA99DAFCEAF18F8B41882720316450F1B1CA48B418C9736E5CE4AFF996111 │ │ │ │ │ -5F7FE80958B6A3498508E9693CB134402D92E30D4C2939070D4647E13682290E │ │ │ │ │ -1D0820A3FCA7147157D09D1A40771F214EAE7DD743EA26839E535CA186C05CB8 │ │ │ │ │ -4874988AA1104D85AF0220FE7224344FF624E794BD2454E1C0AC971522FBECBA │ │ │ │ │ -B2497F25CD621B77EC5160973EF5ECC39C183DC051B0DFCB090194A2525BD96E │ │ │ │ │ -28593FDA80D8D259F039416D5F9AF0AD3C9A105B49DAF6E681921E369B7666C6 │ │ │ │ │ -2B73DB37447B00AE96317C2F1C44FB6E6EFD740BAB20FA03A8CE018EC8415582 │ │ │ │ │ -FB06E88A2971E3A480FB1EB4FE93CC7E5179721CAABEE88742B13CF0405F49F4 │ │ │ │ │ -945E587668C821D8C06D6847B6DF84CAFFCD4628670D551FC5F7236875BE1207 │ │ │ │ │ -634BA7F70A19B658FAE7D86F6D00ED28FBF29CC585DEE279325EEF8B0CCB6149 │ │ │ │ │ -E46E638C73D75148F18A636DBC2DD96ED34F68A5A09A3700B1EA34B2D142807C │ │ │ │ │ -F8709D81180783548EAE6F457BF968602076A1069163E3C15BBCEF659C6CF2E6 │ │ │ │ │ -0BB01BDC8E503802CC7969A5B8477E9788C5249B23B19669F5075E089738E49A │ │ │ │ │ -8671D7C1B1B47652F3D78BF2FF74EDB44BA5B092E8D5B85001E97F69D54AEEFC │ │ │ │ │ -88FC3CA1B0D5BAC39263B371005BCFA19AD197A31CC34D0BD55C2CA18C60C485 │ │ │ │ │ -5993F736EF1DD2C5D2B4D50B3D498861B4DF5E7AFF614BBCA4C2E6BECC0DCEF5 │ │ │ │ │ -95F0D686188014C530D8E37650CDCAE721B4AFB0F178BC744BDDDED45DAB7FEB │ │ │ │ │ -A10B975E26099E3DC61116D6BF554574F948895B88EEFE03DCC5351190836AD4 │ │ │ │ │ -EBC1AC55C6D099A8E7B0A372D290C481F44FA464B9C11A0BC991CB045E0AAAC4 │ │ │ │ │ -5C73CA43A4F17D1ADDD33D1B917FF95BFF411C8409F41553B1BC97DE47E3A1F4 │ │ │ │ │ -A5C1D1B7B1BF7E2507AC53956C141411F4F657E37981996DD7BB7ADB2CB6AE01 │ │ │ │ │ -73D0876B8F896F626D5022FE53BA34D5668BD698BE8D5CCAD083CBCEF440BE6A │ │ │ │ │ -8090EB1CDEE5F99C8988650BD4E539B357C31C597D8A9104A9D5967D4E906CAD │ │ │ │ │ -2A65575A884B1C5F6CC509E742FA9DDD66494F219178161AF72C50848E226A95 │ │ │ │ │ -A8C247FF9FF0BABD073021271B5C0692F9BE220071DAB09E5A026629371EE3C4 │ │ │ │ │ -A6E4FA94625D87A5B66EF077ED54C72B1052AEAA9637B30C76EF8EB04AD5F476 │ │ │ │ │ -D15F1C93C0BC6E0F67B366097BBED03FE82C040F9EF02866159B46854E11D44F │ │ │ │ │ -54AE6748A7E61B993A4EECD3B8BE3B5897A66BBCDFE24F65BC2AD5AB49048CF1 │ │ │ │ │ -647203823F84DF5CB483096F9D96AEE3A2855E479B72A14A67C633CE99C101CF │ │ │ │ │ -EFAE939BF9B02E710D │ │ │ │ │ +1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004ACD1870 │ │ │ │ │ +A5EA947858F5795870BFE1343AD803FB854BF8F5A4E794E8EC57BE41DB5B8734 │ │ │ │ │ +13E47950F29A81EA0C81EA798863883D7F41F78325CA190CBBFFE822AE494550 │ │ │ │ │ +4BE83703071FC9512D128927AF3F63CEF8F86ABE1E15D7B4DDD39576E7DFF45E │ │ │ │ │ +3CB4115AAB1830DE8647B915DB4BEBEB5235C281E098B899BAB951D8D5798F01 │ │ │ │ │ +7F7C47336D31438E5126738AFEAB29E9A7CBE06DE4DD604477B542D2620DFD58 │ │ │ │ │ +28FE34238572F23C5A8EB7ACEE1E154DA13FC1A5AA67A3BA8C5CDFB2B80312C9 │ │ │ │ │ +BC9FAE56D08DDFA9498E6EF0D0F6BD18B3923E0B670B0740528BC843610736CB │ │ │ │ │ +80228C105C2F72C3C22D610C3D8C268DEEA2AEEE3221E198E79FE2966487360C │ │ │ │ │ +84AE08AC326F48B21447652121B1EB68AF856055EEA65B6B625BF622CBFC2D1C │ │ │ │ │ +EF943CC4CAF2C715782C9EF9A9BA4689BFC6B6A82F8D55795BE8111E2C7DE520 │ │ │ │ │ +367362304B6A48186C842033E715A46265A352472F4F7313248EBCD26BEA97E7 │ │ │ │ │ +B814A61D4B7ADCB5C5F21AA34E0C1269E8426DBFB511DE6E26B960456C8F8520 │ │ │ │ │ +5F0DD382289A62AF0B935EDB5B2394538C5F0EE72962D2F98F3C38CD7C027B9F │ │ │ │ │ +E230E67E40FEFBDED06B3423C9DFD669E6B5BC913E0FF75786A64A6C11D4FE89 │ │ │ │ │ +1B918DC0E953C52CFD153063CD0D2A78B43F8712243845E6F2CBA1DB610F403D │ │ │ │ │ +A98D06D95FF44C7AC029092B666A8B0DCEA95B34F5ACC10E8611BADE6A24469C │ │ │ │ │ +0C01D95BFB445FA22CD38D033E4D24E006BB9D54EE41EF7AD5AC9C299721F61A │ │ │ │ │ +F01B6EDCDF428BD9195A13C5B1027358F8A203F828A1DD9622243B2D76C6F1BA │ │ │ │ │ +9F2D7E9D4879FC668ABC750CD25415DC6CCF2257C28F78D3F9BE499CC0FF2F80 │ │ │ │ │ +2C2CD1DEFABD6668FCA76E1D629A344333E33DA24B86D2E9F8F5EE1C29974640 │ │ │ │ │ +C3E78E999BAB313400041DADDDFDBFFCC419F129A84F4D412B79E8BE4511CA00 │ │ │ │ │ +F92A4F3CDD2E51345D3965C104F06B6503445DC20224CB7606A9D7D5F9EE45E6 │ │ │ │ │ +1B2963DA96AA2AB1BA5BE29656E666E4D0E122DE58EEA68E04ED76438DA03E65 │ │ │ │ │ +B80055A86B7B2A26BAE6BBB8835E17F9696E9B3CD34571BA75C76D4D2CCC48F1 │ │ │ │ │ +7534C1EF9127E374D65D05B8072E08D6C72A0B4A35EA0DD717743C66D105CCD8 │ │ │ │ │ +7355F13E9C38C1A4351624E689ED7909100942FA0474842EE44DEC3279E1A1CD │ │ │ │ │ +8064666EB845CA7C3E906B67C0BF96A28D514DB2E4A1E4AF287350B03762A2CF │ │ │ │ │ +13B18AC3F5D2F3B74A1D50267C03EFB74B888E1D24ABEEA4A885F4D0BF14C0D8 │ │ │ │ │ +289AC79D6D98E2A2C831672FB1F3457564CD161ADC3AF610D88201AB5B0C10CB │ │ │ │ │ +5ECCC2D5C4AF39C8CB3044BF9EC791BA45D29C2B51EA0483D19822C264CE6FA3 │ │ │ │ │ +5C97F2DF5A78CB93528E99B9ED7CB121C83130C129B849B52A36EBD88AF19DD3 │ │ │ │ │ +C5CABE831027388EF86BD5CBD90AAAC089775938A321C44D4DDA67A51312D8AB │ │ │ │ │ +C509DDBE7044A107AB2BE9C4C9556F85C529B174A7778B489BF28EC07A834542 │ │ │ │ │ +8B31F2925C21FB2096877711F998763D5A8495002B8E080AF8DBB1B3106EDDBA │ │ │ │ │ +35121D52E0846A7AF3ABEDF87BDE4FA665673A9B80CA538B98F873947AA17EF4 │ │ │ │ │ +9BB182917E9D79BC7EC681E93710D6A1D6B0E4A7FA9452FC1C431808174F3AB7 │ │ │ │ │ +F3914FBC86CB34E8583457243C3C7BE4BC166C7397689BC6FFB82EA2967E88EE │ │ │ │ │ +464F96EDA144DE2B64401B8E577ABCA2D826FE0B92E21FFAE3E81EBB6B6EB36E │ │ │ │ │ +9B1A8FE3884CA398C03135FD49D51724FC1268E9482E41FAEA2FC6C809006B8F │ │ │ │ │ +5D4F9E038450AD3A6041C16FD1C7E5FC80C0E033CE57E64863E014531D94DF1E │ │ │ │ │ +31D7D038AFCB60715AA73C1E96F113A24C5AF35BBEB61C4D079ED034ED83AA4A │ │ │ │ │ +E12448E618330463304788BCF40561CD63167B3BF144F408E2B89E60B8BA13EF │ │ │ │ │ +3B57D286FD23D4FA8BAEFF98DC1188B1982956CC1DCAEFC7D949B7B4E3BE8F8A │ │ │ │ │ +BFE2C9D938DD13EFEE7123576608D9396F260907DA98AE2D3DD5822306CBC8A6 │ │ │ │ │ +B083C697DDA3C62EE7879436A9FD8EE0034B105105B3F122F893EA2126EBE8A9 │ │ │ │ │ +5CBF2BD248DD9FBEF0040C25797BD13B69A8C9F0D4E4F935C61ED30487CCDB1A │ │ │ │ │ +0339006E78EE1755929D2412776EC7DB1F666DBDD28EA8AC7397F809C7F38A41 │ │ │ │ │ +5B3BF6C75F4F35C90141EB08377AF452CF840FEA938805F9D14E02DC29215B4E │ │ │ │ │ +F1EB │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ @@ -4091,19 +4082,19 @@ │ │ │ │ │ %%EndFont │ │ │ │ │ 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 23[45 │ │ │ │ │ -19[83 18[25 2[45 2[45 1[45 45 45 3[25 44[{}10 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 │ │ │ │ │ +69 2[68 6[28 58[{}16 90.9091 /CMTI10 rf /Fe 138[51 6[51 │ │ │ │ │ +8[40 26[47 15[25 4[45 2[45 1[45 3[25 44[{}9 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 │ │ │ │ │ /tieaccentlowercase.new/tieaccentcapital.new/.notdef/afii61664.asc/uni2422 3 │ │ │ │ │ {/.notdef}repeat/dollar/.notdef/.notdef/quotesingle/.notdef/.notdef │ │ │ │ │ @@ -4200,17 +4191,17 @@ │ │ │ │ │ (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 1227 4 v │ │ │ │ │ -1409 w Fj(Chv)29 b Fe(:)41 b Fd(DRAFT)30 b Fe(Ma)m(y)h(17,)h(2024)p │ │ │ │ │ -2674 100 V 0 399 a Fc(1.2.1)112 b(Basic)38 b(metho)s(ds)0 │ │ │ │ │ +TeXDict begin 2 1 bop 0 100 a Fl(2)p 136 100 1220 4 v │ │ │ │ │ +1402 w Fj(Chv)29 b Fe(:)41 b Fd(DRAFT)30 b Fe(June)f(20,)j(2025)p │ │ │ │ │ +2681 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 │ │ │ │ │ @@ -4266,17 +4257,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 1227 4 v 1408 100 a Fj(Chv)30 │ │ │ │ │ -b Fe(:)40 b Fd(DRAFT)121 b Fe(Ma)m(y)32 b(17,)f(2024)p │ │ │ │ │ -2626 100 V 1227 w Fl(3)111 399 y(3.)46 b Fj(void)h │ │ │ │ │ +TeXDict begin 3 2 bop 91 100 1220 4 v 1401 100 a Fj(Chv)30 │ │ │ │ │ +b Fe(:)40 b Fd(DRAFT)121 b Fe(June)30 b(20,)h(2025)p │ │ │ │ │ +2633 100 V 1220 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 │ │ │ │ │ @@ -4337,17 +4328,17 @@ │ │ │ │ │ 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 1227 4 v │ │ │ │ │ -1409 w Fj(Chv)29 b Fe(:)41 b Fd(DRAFT)30 b Fe(Ma)m(y)h(17,)h(2024)p │ │ │ │ │ -2674 100 V 227 399 a Fg(Note:)52 b Fl(this)36 b(metho)s(d)g(w)m(as)g │ │ │ │ │ +TeXDict begin 4 3 bop 0 100 a Fl(4)p 136 100 1220 4 v │ │ │ │ │ +1402 w Fj(Chv)29 b Fe(:)41 b Fd(DRAFT)30 b Fe(June)f(20,)j(2025)p │ │ │ │ │ +2681 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 │ │ │ │ │ ├── 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 May 17, 2024 │ │ │ │ │ │ + 2 Chv : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 3 │ │ │ │ │ │ + Chv : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 4 Chv : DRAFT June 20, 2025 │ │ │ │ │ │ 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 2024.05.17:2218 │ │ │ │ │ +%DVIPSSource: TeX output 2025.06.20:0450 │ │ │ │ │ %%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 │ │ │ │ │ @@ -1014,22 +1014,21 @@ │ │ │ │ │ /UnderlinePosition -100 def │ │ │ │ │ /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 49 /one put │ │ │ │ │ dup 50 /two put │ │ │ │ │ -dup 52 /four put │ │ │ │ │ -dup 55 /seven put │ │ │ │ │ +dup 53 /five put │ │ │ │ │ dup 58 /colon put │ │ │ │ │ -dup 77 /M put │ │ │ │ │ -dup 97 /a put │ │ │ │ │ -dup 121 /y put │ │ │ │ │ +dup 74 /J put │ │ │ │ │ +dup 101 /e put │ │ │ │ │ +dup 110 /n put │ │ │ │ │ +dup 117 /u put │ │ │ │ │ readonly def │ │ │ │ │ currentdict end │ │ │ │ │ currentfile eexec │ │ │ │ │ D9D66F633B846AB284BCF8B0411B772DE5CE32340DC6F28AF40857E4451976E7 │ │ │ │ │ 5182433CF9F333A38BD841C0D4E68BF9E012EB32A8FFB76B5816306B5EDF7C99 │ │ │ │ │ 8B3A16D9B4BC056662E32C7CD0123DFAEB734C7532E64BBFBF5A60336E646716 │ │ │ │ │ EFB852C877F440D329172C71F1E5D59CE9473C26B8AEF7AD68EF0727B6EC2E0C │ │ │ │ │ @@ -1210,72 +1209,64 @@ │ │ │ │ │ 7CA1534C4D5B05FC33F83790ECFD7641DF3FB94289E2A1F6E7D29AB1228A867A │ │ │ │ │ 6E1EF0E9C6F899B491DC18401C2C0A05FFFED46A72C245F7529B8EA55A038082 │ │ │ │ │ 8512307217D2A233C37004085BA3AEE379269F9FA7D0ADB4B19A95CC2AFE686E │ │ │ │ │ 55D88E47257C1FE6F235FEA295910569FE6DD5995512562359CC821E85A6C7A5 │ │ │ │ │ 79B470A9E340A6985189FF8B6AF914A6B0ECF93F47903221F95DE894A8F05B05 │ │ │ │ │ B7D99CD533EC5F931B18E6B39BECF67FA2D6DD1AEC76772B068BE06335A94C05 │ │ │ │ │ 7A4DDEE77B66101DA855C17AC312600370B34E31F5EC3A01300A8EB60B4C9767 │ │ │ │ │ -1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004B9BA1CC │ │ │ │ │ -580D3C6BDA4DC1B80B4365F1C80512453FC5316EC2D928FB731C3D6403E3C18B │ │ │ │ │ -E8424D644DF5E9A2134229C5C91CA68DB8E85BA2BB40F538F585DA6FA4037718 │ │ │ │ │ -B8053EBBA1E765346BCD5BDAA6C38115D31611D8A87A2238C145F2DA2F92E4DF │ │ │ │ │ -3987BD9C4D2A3D460E8941A68B125BCD9EE4F9FD262C4C8A71F47A2C81975635 │ │ │ │ │ -F1B981C274C53FA2ACCDE4C9D0A7C62D6C1EFF91CFC6712CA6A9F333C9564FCB │ │ │ │ │ -2A70F0AD715A79B10A08AB069E2A3C93BC0AED19D0CA10134B8DDDE8AF548DB2 │ │ │ │ │ -3A4AAA9C29682CF135BB767DAA16169A127EB50A7EECEB6480CF56A7D0F8AC56 │ │ │ │ │ -4A5090B3D75A790372886AF568D94C8165975A05BFBFDF1FFBA45F70700BB9E0 │ │ │ │ │ -57F3249EF9E9C8AD9CBCF6E4FD592DC4CDD2CC7C0BC3130C1059096C657BE453 │ │ │ │ │ -A2CBACE93420210E27AF56CA229BD6D982FB68B3FDC6D44478B922C4231C47EE │ │ │ │ │ -E500232F6C11D92DEB955F66DF52B92B22E7352790CC2DCBAC53965D57AC2920 │ │ │ │ │ -68B7D520DE25047146EFEB06B9AD4E2A94243C7E5239F0BC2FC312B16051D52C │ │ │ │ │ -0B92C217B6B42997321AE4F8BB066754B7AA3F15069EF59224E8A442CE471AA7 │ │ │ │ │ -E8049A3DD9EDA09CCEE4998998661CF7DB35E952F6C65DAEB3013951C59F3E09 │ │ │ │ │ -157F313B0237876E1C0190F0473819570B8C0205AADF05D787CC00979CFB327A │ │ │ │ │ -289382B22DDA6F12804ED0ED5B179E36A995A2A59E1B66E75130DBE9109C813B │ │ │ │ │ -94403E0DEA8314A1E9DB474D7FA83C0BAFD08033E6A6215844C1D26BE15F1251 │ │ │ │ │ -A1605E8DF9A9C601ED37379530BC1C82BE5463C6C711C5652BFD6262485AA9CA │ │ │ │ │ -B8C4A117593001D08D980041E2A83C190DCE8E6CD3D334E5CC19FC05DB30F7F7 │ │ │ │ │ -24A305C4DBB31F0651392B99D44B4302333BDF7E326FD256DD75D309C6E73F85 │ │ │ │ │ -FA71B35FD1F9BEFF4C7A1076362EEB0A85492933B6006086A7B8C1928CF2D1EE │ │ │ │ │ -FD4344409257BB802C117E739960821CD3C88BFBA5669FF16F610AD638AF3677 │ │ │ │ │ -8674C985E6767253ED5769F71BEA5E9BB02A751F9E62EE2B18AC19D975FDEAE9 │ │ │ │ │ -8B8822367FF177A7E850766DE99ED3366D46464612926430012212A90F8E85F4 │ │ │ │ │ -4760B40D5B86B90819EE410382C23E86DCAF4F0FF5DFEB2C285965F4DCF2FB2B │ │ │ │ │ -457C0A0427A8D4ADA514E9DACD0F9367E1DA225DB21DA4DDAE33F2B529686D92 │ │ │ │ │ -AC085B345565F9DFFA012FD494DBB2E0B44A0787B2B72DC8D25399DAAE8864B7 │ │ │ │ │ -E84AA99DAFCEAF18F8B41882720316450F1B1CA48B418C9736E5CE4AFF996111 │ │ │ │ │ -5F7FE80958B6A3498508E9693CB134402D92E30D4C2939070D4647E13682290E │ │ │ │ │ -1D0820A3FCA7147157D09D1A40771F214EAE7DD743EA26839E535CA186C05CB8 │ │ │ │ │ -4874988AA1104D85AF0220FE7224344FF624E794BD2454E1C0AC971522FBECBA │ │ │ │ │ -B2497F25CD621B77EC5160973EF5ECC39C183DC051B0DFCB090194A2525BD96E │ │ │ │ │ -28593FDA80D8D259F039416D5F9AF0AD3C9A105B49DAF6E681921E369B7666C6 │ │ │ │ │ -2B73DB37447B00AE96317C2F1C44FB6E6EFD740BAB20FA03A8CE018EC8415582 │ │ │ │ │ -FB06E88A2971E3A480FB1EB4FE93CC7E5179721CAABEE88742B13CF0405F49F4 │ │ │ │ │ -945E587668C821D8C06D6847B6DF84CAFFCD4628670D551FC5F7236875BE1207 │ │ │ │ │ -634BA7F70A19B658FAE7D86F6D00ED28FBF29CC585DEE279325EEF8B0CCB6149 │ │ │ │ │ -E46E638C73D75148F18A636DBC2DD96ED34F68A5A09A3700B1EA34B2D142807C │ │ │ │ │ -F8709D81180783548EAE6F457BF968602076A1069163E3C15BBCEF659C6CF2E6 │ │ │ │ │ -0BB01BDC8E503802CC7969A5B8477E9788C5249B23B19669F5075E089738E49A │ │ │ │ │ -8671D7C1B1B47652F3D78BF2FF74EDB44BA5B092E8D5B85001E97F69D54AEEFC │ │ │ │ │ -88FC3CA1B0D5BAC39263B371005BCFA19AD197A31CC34D0BD55C2CA18C60C485 │ │ │ │ │ -5993F736EF1DD2C5D2B4D50B3D498861B4DF5E7AFF614BBCA4C2E6BECC0DCEF5 │ │ │ │ │ -95F0D686188014C530D8E37650CDCAE721B4AFB0F178BC744BDDDED45DAB7FEB │ │ │ │ │ -A10B975E26099E3DC61116D6BF554574F948895B88EEFE03DCC5351190836AD4 │ │ │ │ │ -EBC1AC55C6D099A8E7B0A372D290C481F44FA464B9C11A0BC991CB045E0AAAC4 │ │ │ │ │ -5C73CA43A4F17D1ADDD33D1B917FF95BFF411C8409F41553B1BC97DE47E3A1F4 │ │ │ │ │ -A5C1D1B7B1BF7E2507AC53956C141411F4F657E37981996DD7BB7ADB2CB6AE01 │ │ │ │ │ -73D0876B8F896F626D5022FE53BA34D5668BD698BE8D5CCAD083CBCEF440BE6A │ │ │ │ │ -8090EB1CDEE5F99C8988650BD4E539B357C31C597D8A9104A9D5967D4E906CAD │ │ │ │ │ -2A65575A884B1C5F6CC509E742FA9DDD66494F219178161AF72C50848E226A95 │ │ │ │ │ -A8C247FF9FF0BABD073021271B5C0692F9BE220071DAB09E5A026629371EE3C4 │ │ │ │ │ -A6E4FA94625D87A5B66EF077ED54C72B1052AEAA9637B30C76EF8EB04AD5F476 │ │ │ │ │ -D15F1C93C0BC6E0F67B366097BBED03FE82C040F9EF02866159B46854E11D44F │ │ │ │ │ -54AE6748A7E61B993A4EECD3B8BE3B5897A66BBCDFE24F65BC2AD5AB49048CF1 │ │ │ │ │ -647203823F84DF5CB483096F9D96AEE3A2855E479B72A14A67C633CE99C101CF │ │ │ │ │ -EFAE939BF9B02E710D │ │ │ │ │ +1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004ACD1870 │ │ │ │ │ +A5EA947858F5795870BFE1343AD803FB854BF8F5A4E794E8EC57BE41DB5B8734 │ │ │ │ │ +13E47950F29A81EA0C81EA798863883D7F41F78325CA190CBBFFE822AE494550 │ │ │ │ │ +4BE83703071FC9512D128927AF3F63CEF8F86ABE1E15D7B4DDD39576E7DFF45E │ │ │ │ │ +3CB4115AAB1830DE8647B915DB4BEBEB5235C281E098B899BAB951D8D5798F01 │ │ │ │ │ +7F7C47336D31438E5126738AFEAB29E9A7CBE06DE4DD604477B542D2620DFD58 │ │ │ │ │ +28FE34238572F23C5A8EB7ACEE1E154DA13FC1A5AA67A3BA8C5CDFB2B80312C9 │ │ │ │ │ +BC9FAE56D08DDFA9498E6EF0D0F6BD18B3923E0B670B0740528BC843610736CB │ │ │ │ │ +80228C105C2F72C3C22D610C3D8C268DEEA2AEEE3221E198E79FE2966487360C │ │ │ │ │ +84AE08AC326F48B21447652121B1EB68AF856055EEA65B6B625BF622CBFC2D1C │ │ │ │ │ +EF943CC4CAF2C715782C9EF9A9BA4689BFC6B6A82F8D55795BE8111E2C7DE520 │ │ │ │ │ +367362304B6A48186C842033E715A46265A352472F4F7313248EBCD26BEA97E7 │ │ │ │ │ +B814A61D4B7ADCB5C5F21AA34E0C1269E8426DBFB511DE6E26B960456C8F8520 │ │ │ │ │ +5F0DD382289A62AF0B935EDB5B2394538C5F0EE72962D2F98F3C38CD7C027B9F │ │ │ │ │ +E230E67E40FEFBDED06B3423C9DFD669E6B5BC913E0FF75786A64A6C11D4FE89 │ │ │ │ │ +1B918DC0E953C52CFD153063CD0D2A78B43F8712243845E6F2CBA1DB610F403D │ │ │ │ │ +A98D06D95FF44C7AC029092B666A8B0DCEA95B34F5ACC10E8611BADE6A24469C │ │ │ │ │ +0C01D95BFB445FA22CD38D033E4D24E006BB9D54EE41EF7AD5AC9C299721F61A │ │ │ │ │ +F01B6EDCDF428BD9195A13C5B1027358F8A203F828A1DD9622243B2D76C6F1BA │ │ │ │ │ +9F2D7E9D4879FC668ABC750CD25415DC6CCF2257C28F78D3F9BE499CC0FF2F80 │ │ │ │ │ +2C2CD1DEFABD6668FCA76E1D629A344333E33DA24B86D2E9F8F5EE1C29974640 │ │ │ │ │ +C3E78E999BAB313400041DADDDFDBFFCC419F129A84F4D412B79E8BE4511CA00 │ │ │ │ │ +F92A4F3CDD2E51345D3965C104F06B6503445DC20224CB7606A9D7D5F9EE45E6 │ │ │ │ │ +1B2963DA96AA2AB1BA5BE29656E666E4D0E122DE58EEA68E04ED76438DA03E65 │ │ │ │ │ +B80055A86B7B2A26BAE6BBB8835E17F9696E9B3CD34571BA75C76D4D2CCC48F1 │ │ │ │ │ +7534C1EF9127E374D65D05B8072E08D6C72A0B4A35EA0DD717743C66D105CCD8 │ │ │ │ │ +7355F13E9C38C1A4351624E689ED7909100942FA0474842EE44DEC3279E1A1CD │ │ │ │ │ +8064666EB845CA7C3E906B67C0BF96A28D514DB2E4A1E4AF287350B03762A2CF │ │ │ │ │ +13B18AC3F5D2F3B74A1D50267C03EFB74B888E1D24ABEEA4A885F4D0BF14C0D8 │ │ │ │ │ +289AC79D6D98E2A2C831672FB1F3457564CD161ADC3AF610D88201AB5B0C10CB │ │ │ │ │ +5ECCC2D5C4AF39C8CB3044BF9EC791BA45D29C2B51EA0483D19822C264CE6FA3 │ │ │ │ │ +5C97F2DF5A78CB93528E99B9ED7CB121C83130C129B849B52A36EBD88AF19DD3 │ │ │ │ │ +C5CABE831027388EF86BD5CBD90AAAC089775938A321C44D4DDA67A51312D8AB │ │ │ │ │ +C509DDBE7044A107AB2BE9C4C9556F85C529B174A7778B489BF28EC07A834542 │ │ │ │ │ +8B31F2925C21FB2096877711F998763D5A8495002B8E080AF8DBB1B3106EDDBA │ │ │ │ │ +35121D52E0846A7AF3ABEDF87BDE4FA665673A9B80CA538B98F873947AA17EF4 │ │ │ │ │ +9BB182917E9D79BC7EC681E93710D6A1D6B0E4A7FA9452FC1C431808174F3AB7 │ │ │ │ │ +F3914FBC86CB34E8583457243C3C7BE4BC166C7397689BC6FFB82EA2967E88EE │ │ │ │ │ +464F96EDA144DE2B64401B8E577ABCA2D826FE0B92E21FFAE3E81EBB6B6EB36E │ │ │ │ │ +9B1A8FE3884CA398C03135FD49D51724FC1268E9482E41FAEA2FC6C809006B8F │ │ │ │ │ +5D4F9E038450AD3A6041C16FD1C7E5FC80C0E033CE57E64863E014531D94DF1E │ │ │ │ │ +31D7D038AFCB60715AA73C1E96F113A24C5AF35BBEB61C4D079ED034ED83AA4A │ │ │ │ │ +E12448E618330463304788BCF40561CD63167B3BF144F408E2B89E60B8BA13EF │ │ │ │ │ +3B57D286FD23D4FA8BAEFF98DC1188B1982956CC1DCAEFC7D949B7B4E3BE8F8A │ │ │ │ │ +BFE2C9D938DD13EFEE7123576608D9396F260907DA98AE2D3DD5822306CBC8A6 │ │ │ │ │ +B083C697DDA3C62EE7879436A9FD8EE0034B105105B3F122F893EA2126EBE8A9 │ │ │ │ │ +5CBF2BD248DD9FBEF0040C25797BD13B69A8C9F0D4E4F935C61ED30487CCDB1A │ │ │ │ │ +0339006E78EE1755929D2412776EC7DB1F666DBDD28EA8AC7397F809C7F38A41 │ │ │ │ │ +5B3BF6C75F4F35C90141EB08377AF452CF840FEA938805F9D14E02DC29215B4E │ │ │ │ │ +F1EB │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ @@ -3500,18 +3491,18 @@ │ │ │ │ │ 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 23[45 19[83 18[25 │ │ │ │ │ -2[45 2[45 1[45 45 45 3[25 44[{}10 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 │ │ │ │ │ +46[{}24 99.6264 /CMBX12 rf /Fb 138[51 6[51 8[40 26[47 │ │ │ │ │ +15[25 4[45 2[45 1[45 3[25 44[{}9 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 │ │ │ │ │ @@ -3604,17 +3595,17 @@ │ │ │ │ │ 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 1208 4 v │ │ │ │ │ -1390 w Fi(PERM)29 b Fb(:)i Fg(DRAFT)f Fb(Ma)m(y)h(17,)h(2024)p │ │ │ │ │ -2692 100 V 0 399 a Fa(1.2.1)112 b(Basic)38 b(metho)s(ds)0 │ │ │ │ │ +TeXDict begin 2 1 bop 0 100 a Fj(2)p 136 100 1201 4 v │ │ │ │ │ +1383 w Fi(PERM)29 b Fb(:)i Fg(DRAFT)f Fb(June)f(20,)j(2025)p │ │ │ │ │ +2699 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) │ │ │ │ │ @@ -3669,17 +3660,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 1208 4 v 1389 100 a Fi(PERM)30 │ │ │ │ │ -b Fb(:)g Fg(DRAFT)121 b Fb(Ma)m(y)32 b(17,)f(2024)p 2645 │ │ │ │ │ -100 V 1208 w Fj(3)111 399 y(2.)46 b Fi(int)h(Perm_checkPerm)d(\()k │ │ │ │ │ +TeXDict begin 3 2 bop 91 100 1201 4 v 1382 100 a Fi(PERM)30 │ │ │ │ │ +b Fb(:)g Fg(DRAFT)121 b Fb(June)30 b(20,)h(2025)p 2652 │ │ │ │ │ +100 V 1201 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 │ │ │ │ │ @@ -3739,17 +3730,17 @@ │ │ │ │ │ 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 1208 4 v │ │ │ │ │ -1390 w Fi(PERM)29 b Fb(:)i Fg(DRAFT)f Fb(Ma)m(y)h(17,)h(2024)p │ │ │ │ │ -2692 100 V 111 399 a Fj(1.)46 b Fi(int)h(Perm_readFromFile)c(\()48 │ │ │ │ │ +TeXDict begin 4 3 bop 0 100 a Fj(4)p 136 100 1201 4 v │ │ │ │ │ +1383 w Fi(PERM)29 b Fb(:)i Fg(DRAFT)f Fb(June)f(20,)j(2025)p │ │ │ │ │ +2699 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 │ │ │ │ │ @@ -3829,17 +3820,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 1208 4 v 1389 100 a Fi(PERM)30 │ │ │ │ │ -b Fb(:)g Fg(DRAFT)121 b Fb(Ma)m(y)32 b(17,)f(2024)p 2645 │ │ │ │ │ -100 V 1208 w Fj(5)111 399 y(8.)46 b Fi(int)h(Perm_writeStats)d(\()j │ │ │ │ │ +TeXDict begin 5 4 bop 91 100 1201 4 v 1382 100 a Fi(PERM)30 │ │ │ │ │ +b Fb(:)g Fg(DRAFT)121 b Fb(June)30 b(20,)h(2025)p 2652 │ │ │ │ │ +100 V 1201 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 May 17, 2024 │ │ │ │ │ │ + 2 PERM : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 3 │ │ │ │ │ │ + PERM : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 4 PERM : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 5 │ │ │ │ │ │ + PERM : DRAFT June 20, 2025 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 │ │ │ │ │ @@ -8,15 +8,15 @@ │ │ │ │ │ %%DocumentFonts: CMR17 CMBX12 CMR12 CMR8 CMR6 CMR9 CMTT9 CMBX10 CMR10 │ │ │ │ │ %%+ CMR7 CMBX8 │ │ │ │ │ %%DocumentPaperSizes: Letter │ │ │ │ │ %%EndComments │ │ │ │ │ %DVIPSWebPage: (www.radicaleye.com) │ │ │ │ │ %DVIPSCommandLine: dvips main -o ReferenceManual.ps │ │ │ │ │ %DVIPSParameters: dpi=600 │ │ │ │ │ -%DVIPSSource: TeX output 2024.05.17:2217 │ │ │ │ │ +%DVIPSSource: TeX output 2025.06.20:0449 │ │ │ │ │ %%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 │ │ │ │ │ @@ -3848,24 +3848,21 @@ │ │ │ │ │ /UnderlineThickness 50 def │ │ │ │ │ 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 49 /one put │ │ │ │ │ dup 50 /two put │ │ │ │ │ -dup 52 /four put │ │ │ │ │ -dup 55 /seven put │ │ │ │ │ +dup 53 /five put │ │ │ │ │ dup 65 /A put │ │ │ │ │ dup 67 /C put │ │ │ │ │ dup 68 /D put │ │ │ │ │ dup 74 /J put │ │ │ │ │ dup 75 /K put │ │ │ │ │ -dup 77 /M put │ │ │ │ │ dup 80 /P put │ │ │ │ │ dup 87 /W put │ │ │ │ │ dup 97 /a put │ │ │ │ │ dup 99 /c put │ │ │ │ │ dup 100 /d put │ │ │ │ │ dup 101 /e put │ │ │ │ │ dup 102 /f put │ │ │ │ │ @@ -3875,15 +3872,14 @@ │ │ │ │ │ dup 110 /n put │ │ │ │ │ dup 111 /o put │ │ │ │ │ dup 114 /r put │ │ │ │ │ dup 115 /s put │ │ │ │ │ dup 116 /t put │ │ │ │ │ dup 117 /u put │ │ │ │ │ dup 118 /v put │ │ │ │ │ -dup 121 /y put │ │ │ │ │ readonly def │ │ │ │ │ currentdict end │ │ │ │ │ currentfile eexec │ │ │ │ │ D9D66F633B846AB284BCF8B0411B772DE5CE3DD325E55798292D7BD972BD75FA │ │ │ │ │ 0E079529AF9C82DF72F64195C9C210DCE34528F540DA1FFD7BEBB9B40787BA93 │ │ │ │ │ 51BBFB7CFC5F9152D1E5BB0AD8D016C6CFA4EB41B3C51D091C2D5440E67CFD71 │ │ │ │ │ 7C56816B03B901BF4A25A07175380E50A213F877C44778B3C5AADBCC86D6E551 │ │ │ │ │ @@ -4062,181 +4058,160 @@ │ │ │ │ │ 34DE10D995ABCAF45FBB3B6B73E80D05F4C51F8C29D4B0F67C8A86432A6C5E86 │ │ │ │ │ F0126AB25A5CA2875B48C61CB8112A4CF9AA08F8B0157396CF63CBECDB8867CC │ │ │ │ │ AC10F060630C9BFBAD84B1FF01C814878F0C177F552BDC9BB181B14581C6E968 │ │ │ │ │ DAAAB2896FCFB745795C4D2C87CC15BAA041EF80C5BDC12EC1F5786BB41A5A21 │ │ │ │ │ 073EE0BC436B346E014DB4099EDC67BC432E470A4B779FD556341061CA3F2BE8 │ │ │ │ │ EFA332637AEC878C2BB189CA3267B2BE5B8178E6B7889A33771F86276E6F0B8E │ │ │ │ │ 8E93B816AC7005575762EF4DE45E2794B7322F9B6D8E634FB8FF250D638EB502 │ │ │ │ │ -818321B3C46DB51B8EC6C2EF1D05C716519A3BD6B12A67239898F8A010CB8279 │ │ │ │ │ -86D2D942871606D4B8A274C720E46E43BE44C74224A8520232F7F6C96FC7D6D2 │ │ │ │ │ -EB817F578B294EC22FA123ED64613F3AE96DE23AA1833D2A527F282DC80C38CA │ │ │ │ │ -B5A9D66708ED2293AC1F832C82B70993055FCF9BDE6F5DEAECBE5345572E7D78 │ │ │ │ │ -71D938095EE457512DAABB5278FFBB263323B7FBDC84B52650114DC3DF9E57BB │ │ │ │ │ -C1835D2D17273F234A45642152EA125D909CA252173DAE4D0073D71DC3823955 │ │ │ │ │ -488FADCF5F3B1E500A3059C4E00DAECB29BCACE5456AE77DB22FB7F97E9B9BF2 │ │ │ │ │ -6D89F8080F41B03D402E59FFA3ED920D4DA409ECA9AAD57BAC91C3F1B51279EA │ │ │ │ │ -A3133501892E9E53F3F8A6BDA0FFF9456D027AE49BD31372050313BE55845B85 │ │ │ │ │ -F15380257D6687D5F609325220D553D0F5C384A88E22325B42E6A336A12560BE │ │ │ │ │ -70E273FE85B4E68DD94BD530295F6D981DF936B92F136DF95AEF560EB138CB11 │ │ │ │ │ -EC45F6D29743E46A4DDCB80283409F2C52FF83976BA136A4534307A8DDA639B6 │ │ │ │ │ -2AAD5AA364DDE7579E5946794FC3999FF332D8850933C290757862426C8CBBA7 │ │ │ │ │ -D2AFAC107C0A501BB747EFB9183E5697A649E88DAF39DD80A24B433DE4B2B5D9 │ │ │ │ │ -315579CC46C0FD847530C5F5B784D1282ED79F8BB99F0BB731CF670F82B3B4B9 │ │ │ │ │ -79425967950E55CDA0857D295131E35E83D1CA6EF30BD1B730A2ADEC51A35988 │ │ │ │ │ -E1401D65025C18B8A9D20D1F534CE189AB7F4C276347F590154CAEFE11447B6E │ │ │ │ │ -B26B54D9EA5045D16663BFFFC9226ACB4C4F27E6FCC900581013D8F35F591F21 │ │ │ │ │ -5C29B2514AE0D5D84EE17EE329F031B0686CA3B7B917B70EFABF61C6AD15A635 │ │ │ │ │ -79F42A008A655E3B5EA2588812CE356634B3087BAD1DC71AF15CB1717D51DD38 │ │ │ │ │ -0C7888AD6C8C70430067D73D315E27E3AE5D030DCF63BBB23581373E4B887897 │ │ │ │ │ -36CFBA5CC46385468189986BD3F19ABA08AF3227DEAA3A3C1E4121FDDC428B04 │ │ │ │ │ -ED9DA41B2EF1A62364B18D075FB1A0649E3C263DB01C565580B6F1C56632AFB0 │ │ │ │ │ -0633972999F763D7EF6C77255142D79392F47C52A7A0FBE5170FDA72AFF44B14 │ │ │ │ │ -4288727A4E345FF795F0758BE2CDB2710A2A139640CC73F442D0AD91437CE18B │ │ │ │ │ -1BEB90D08C0D0B29F671FD4FFD6EF1EC92EE86EBFF82024F043B8A1FE8B54BD8 │ │ │ │ │ -DAFD53C63F5F12999ED4BB120A4B213604D041EF0F2E95062E598934034B9D61 │ │ │ │ │ -5590FFCBDF4C47799B2CCD0830845F085690741D05C6E9F460FF2120BA8237B9 │ │ │ │ │ -3ED61364D9DEC996EAB88EC1103BD187131E9E9E67B2724DB5A35152B464CEF6 │ │ │ │ │ -283C77C907D4C12B4C0FCCAFE83B3069AFAA13753859EC68D10CD4F13EB7387C │ │ │ │ │ -C2487CD9178B72D5DE01EE8A52214B5E7E069C31DB39965810540293C249E6D9 │ │ │ │ │ -D2E8B0F32826DCC3D21D41626A588F632EABC9858B060FDDC9BA7D544CFFB3EA │ │ │ │ │ -62F3F8DDC43B0C49EA38C99C117873BE11A29735AC729E1A0939F1843850E3D7 │ │ │ │ │ -B0009665CA843E649EA912D36262C62BC03F8AC0CECF9AE4DF896975810331B7 │ │ │ │ │ -4A77F71CB6C8E9BF59F3FF4DB83B4F85C28546862622920879CB41DB28CA4752 │ │ │ │ │ -9937F9EEA00CAA0A1644976AB7DE7AF5893521726E24D1E46C8888FA54109149 │ │ │ │ │ -9492C195ACB6B6C6D4637C0EC0ACC346E7FEE77FE286EC31DB7EE3AD4041C7BC │ │ │ │ │ -E0395832DA0296B85BB1CBECA0D1FF10EB8A399082406A89CA01578C33DFEFD9 │ │ │ │ │ -74627D363A029CF7DFF40865CE7083730445A88517E4AAA28B1B205E053C59B8 │ │ │ │ │ -D7524CA167DEEF6559B556012861FA9A8D41245C96F8EF3836B9F1E72AD0B0AE │ │ │ │ │ -09B01E5EB1B46D7F3D0AC14F1F598E273E6AE5366E469CA56915621741611DA9 │ │ │ │ │ -5915279007C2DA6AAB0DE70721F6B1A124894672AA2E20336EE0A1B42AE7FB0A │ │ │ │ │ -908E4B20F5BA4E4CDDE06B7B7C0F9AF1CEFAC5EF47758852AF99F9908AA554FF │ │ │ │ │ -4C28E6474863CF9CE9A2CD454AD24988392C1D6A8E88F0C777E647F61BE51D46 │ │ │ │ │ -A82B02556020A9E5B67BD30CF2188F8DBC75E6EDA76BC8343FC7E6C72759F116 │ │ │ │ │ -1C87A7541864825C7D1EF3596355648F141154D26CF69E9667557A95F20AF4B8 │ │ │ │ │ -F74EF1075D20DD2DCEBD56317E4448F08262974AD3C433A68E96C845E192CDFF │ │ │ │ │ -98E7DBE381FC0FCDA3413EF9798BCAFB57465AA14032B74511084420D9870EF2 │ │ │ │ │ -F2255841A679BDE9704BE5A16A4A781ED36CC703A8708C12F5B4921768AB438D │ │ │ │ │ -84AF99DF0E55878CB2BF56BE645A6750E12464F7724C30D642F080629141859E │ │ │ │ │ -CE890054C00DA2F9A86A95ECDFA2007F5F6D2211D902271F4FE59EF57AA80CE9 │ │ │ │ │ -7E65903297AE77B145DC812A121FB2FE7D0A75C8C3A3107ABE24C9AF46F98A99 │ │ │ │ │ -D0EACDB956A6D546D163001C626AC656BF43562CC70A219C4638E79E34373DD6 │ │ │ │ │ -0AAFD655C8845988C9308D85542B433DF4CA50B8AD60536AEC82134A8A8F0EB1 │ │ │ │ │ -3AAAA75CE4882AC712EB4272E0C4C48558FE51ED58C66C5320695D805D1FFECA │ │ │ │ │ -68F7DD78E9463671DA5C37A8E39E2D9D4D5E4212F8A38EC57814C2FD8466F6BA │ │ │ │ │ -ECE2AFA4F2A04D1054C86611AD783DE2EFA8ED994AABD85A4955177F0190807B │ │ │ │ │ -4C11C610C309BCFEDA41089F2FD048AA82E2F56AB7BB004371B2314CCFB3DC57 │ │ │ │ │ -410B44989382958748509EF29E9785524B058906F1DD669835230509687620C5 │ │ │ │ │ -7C1D4D3378930422F926BCDBE79E5E85A76139B11C53397A003CA6BCFBFEBD5D │ │ │ │ │ -33335F27FC17134516C86EFBE8CB24587C14737D6A56B87E202E978E36338765 │ │ │ │ │ -6C8C70DFCE207CA1673EDA074B8E20B1E0CB3F6D9750410AC31B5AEED81D0143 │ │ │ │ │ -60FBD380DB5F8765619E49AC0817C0A766084CECA47FC7B09781A698BE80A4F7 │ │ │ │ │ -1B653E2811B22F6980F34E0C5AF91BF1021FACB61ACCDA30D27C6A8201436184 │ │ │ │ │ -C898A9B86C9A13CD646841965F74488E95A1BA443C7D89F6DAC2B869D7661A9B │ │ │ │ │ -CB89B8251D2D5E9D88768F8E88614CF1859FB297F8BF5A14083ADC722CC58FA1 │ │ │ │ │ -6769FF59802492B9DB03D411F8364CA8F7597388C34EC98112F068FAC54CA86E │ │ │ │ │ -5B15738BC57226D30C5CAD288FA251BA04A75CA357C341559B371FEF602E9AB6 │ │ │ │ │ -AF7B5B0574DC99D7FD37029EF5376E2824A0C1F1536515C49E6DDC06E9A26393 │ │ │ │ │ -861B3537220A4ED3E6F8AED854C9B481CDAC764B53FA640653BCE24399B300F0 │ │ │ │ │ -962814D2788120CDE4549E9606836A284BB4F57B465CE62F70151210578303C6 │ │ │ │ │ -626448FE262D15ED0D674FAC680F05859A4A9467A95F167229DC01152CEF413A │ │ │ │ │ -65BDD42378D3D3BFE73B79FF8AF1F052DBC25CDFD7BCAAD716F56BB1A0E289C7 │ │ │ │ │ -A90EC4549B9204524B2CAE35A35B4BF7274B02549FCEFBF205328242144D46BC │ │ │ │ │ -D79CDCE9CF62EAC6784CE7370CD7712CC2BAC1C65266250BDED4FC9245C16518 │ │ │ │ │ -D1B92F75137D31E35315BD8202616C27653FD32FF3DECD416AC4DDB79BBDCD6D │ │ │ │ │ -2D88D64243E28FE026EF5ECFB4475908DAD9A399740AC2B137D5CE3839634458 │ │ │ │ │ -F7C1C5086FFC06DECB83ED42DB20632F08909D740EDF5F9BBB6EFB87408F8DFC │ │ │ │ │ -6CD358D2486A4E61BE716FC9EF3540ED8FDC7F1FC7D95489B2DC0F98E4989E94 │ │ │ │ │ -59C2579469FAF417BE9BBF0853534939A88BF52A469C467A0580886CD9EBA3A0 │ │ │ │ │ -FED55B1A560C2D1239955D3B444D7D8522D1FA5E0CD6731B2BDDD67CF192395E │ │ │ │ │ -030E082A6C59E1258629EFAA889239273D3BE9425C74A9C50DEFD2F021644723 │ │ │ │ │ -0F3C431574A1CDB13BBB6ED3ECE64C32798010A44362A10F1795E0C4CF5950EB │ │ │ │ │ -ED8E635986C2A156D8C4A2C6B74D4D88CFA8B66F143285002ABB873579EA74DB │ │ │ │ │ -000BE4659FE249A5D6D33D479E0B6B3A1DF060748A6705A29DC4B862B7F2F357 │ │ │ │ │ -55E31D0AFDFCC0C419166F32C6BDD6ADE21A8E8FDF51145FE1323C4E6089B76A │ │ │ │ │ -5C54278D1D35FBCA0A0EA5C7A8EF1F82A2A6F4A02E4E6E9CED2DDADC389954ED │ │ │ │ │ -CAA9A4F1F43217D6FD30A51381F4F1A5FFA710C5FC8F3501E4CED70390BF870B │ │ │ │ │ -42A8C617E1FE0CDC2294740499A4923D82BA78349830E5E142E49C5F5C60D157 │ │ │ │ │ -350EDB71F8E4EAB02B74996994B640666F6377BE05107A33028B33FE056AC2C0 │ │ │ │ │ -DD68F5D4EFED17376B0C2DDB0DDD4292D4A055EC05DB8468EC6478D6D3C1B043 │ │ │ │ │ -73AC9873165DA8F320BD2A795402240FE497B559EEC92462FCC121F8A1F7331F │ │ │ │ │ -7864291A3B3F759806050291A329CF3DDA5D8871AE0268015BA8523A52A74405 │ │ │ │ │ -34F4AD47E3705C8CDF75A46561848140764ADFCBF68F97419FB4E217C14C886D │ │ │ │ │ -38EDE7764B8B0D4D40EFE16E80DA26BDE67FF7E2DE670AA54AA751E0A37BBBB6 │ │ │ │ │ -F3FA0AB755CB093495FB0FC2B6A7F1E11A32FE36ACA08458BDE06B569F854F39 │ │ │ │ │ -BFBC9346268C6563BA48BC9FC1619B3CCFD8D47298BCD8861F383A59BC1388AC │ │ │ │ │ -F5FA49410F5315233918E77B3E6C402BDFC0F2C3581432A1553F258AA46EEDE2 │ │ │ │ │ -CBDB994D084FAC145B11D27332D0B1A6A32D6B55CA89C192BF972E01CEF5D887 │ │ │ │ │ -DE4BC54FAF0C0C8FEF2796B52C4EC3675AA9C8C1A32CC266ED41891990CDF95E │ │ │ │ │ -A27240EDCBC18CA679029FBCD1710958FA79C316D681882EB451EFDFA251E9C4 │ │ │ │ │ -19116BB2F87A8D7FFBA9F2EA1E46F2C28211C93195EC1588CDD30436D9D1589C │ │ │ │ │ -BB81428780B3F0514106A9E315956B79DE26C8D119A788FBFC23F2EFC8AA6C16 │ │ │ │ │ -2F9B41216D1E2A168D74D9CB140F502F78CDE60C3C3D527EA31E6D57B83C7271 │ │ │ │ │ -F5C65F9BE3B61A425B279F79FA6919F2A90B4BC3405D8CAFBFB7946ECB96FBA7 │ │ │ │ │ -0B317235C752B7B52DC77AB371DC1E2B6DEFA49BF738051331A44262D250CAAD │ │ │ │ │ -CD23E0D97980F20EFD84757E6EED3E7F364B3AF8A8941E844A4BE244B8870D5C │ │ │ │ │ -6A4CA3D19B84BF69DE8931D927B1AC407ABCA7398D276CAECB2F6A8D4752FB6A │ │ │ │ │ -ABB791D22BC9E42D9BAFF56590EA8BA42913E51CA797B0DC64CB999DE1296574 │ │ │ │ │ -03D2D96C07DB937B0717DA3BFD60A8AAD7FC768530173C6D4BD704A8AE312E71 │ │ │ │ │ -61742D4722915F669246E7AEFD53241127A191D93C808485B320424F9B1E3FFD │ │ │ │ │ -124B111CA8F844398377936B5AF16E71F39847E41FCCA66D6CBB60284CFAD11D │ │ │ │ │ -3C151ACE55065051BDB96C7E4DCEB4069BF8FFF9708D58B13EB7149DB90F671B │ │ │ │ │ -02BA487CF6B52F958A0BB5E1580A729CC0F39A44A50FB652EF71AD141B785DB2 │ │ │ │ │ -DAA9BB0D2A43F9C0154F3B6AD0EDA6045151BD50D61A0E1AA41A375C25114A76 │ │ │ │ │ -CA046D190A33A242680FABE7E1E6899C2DD7AFD15A237CB4E8AAFB53E7726D5B │ │ │ │ │ -DEF61C3E479AB024C492C86F8C4794D142C56AB32CC749F6F5450C85C3CE2D05 │ │ │ │ │ -4A90CFEA439AA8C8F266295BE92A624B6940B5979866045E87756EFE829E91DE │ │ │ │ │ -A6B85C16C46B25E67E83DF4DFA21ECD9636844FA4E7760C2F0B25FD3513CCE00 │ │ │ │ │ -4A8AB7161A7B076F1322FA89672C3A35EFCF9B93CAA787654D639F14B3364A05 │ │ │ │ │ -BCA5F32EC41FB282E8A53022DCF88F844520F2CE4A19B0F0BB6B5702C11E948D │ │ │ │ │ -A4CCC82ED2848943461A0634239DEF196B7E0D98733F196ED13341FD40D1D914 │ │ │ │ │ -F6848285E7509667D2AD5E5B6401C74C5DBD4A9C9B91CBCAE54F6C386DB57119 │ │ │ │ │ -4392FF26B114B9EA51612A2638B8B5DDD887E374E9ED860F047AC9D17F73DA6F │ │ │ │ │ -956D8DA3980D898F67654D03B6504E860F6BDEC7253AA93B4700E7F63F6EC8B8 │ │ │ │ │ -6CDAE9C59C07459C24D8564488831A8D9A2F76630110257A4D35608F93AADFCD │ │ │ │ │ -83D31CB478D36AA92DC758185E4C76FB6D2B4FCC68CAF06D413312FF66CEBE92 │ │ │ │ │ -9EB67F0718DE2051037371701A6AB2D8A1776493BF6F36EB90CBBCFC5BDF6C68 │ │ │ │ │ -7BA86AE2A8B7183CD503A6B671D306490404CB393B20F3BD95EF2A2414F1830F │ │ │ │ │ -F65341A07C78C6AAE895AA94E67BD8755297C2C5F940DC86641FF624424367F0 │ │ │ │ │ -25B4A6168760317F5DA3DAB1533F9A3E207494C17319D032DBC79695EF054580 │ │ │ │ │ -7BD811227F6AF345B52C77F4EEA93174C9FDFF3B58CA6956EA86D0A945E82872 │ │ │ │ │ -B3BBA2476DA25F870969898A50C40168CF1601D737EA5CF454F04EC72B53709F │ │ │ │ │ -CEB627B3A3B9A801742E6B219437D9B58F61B190AF7F7BABDB96ADF4DBE7E37B │ │ │ │ │ -515EF5312754AF43A532F6D48FFD433460080CEB81E51E342167B0749AAE7F33 │ │ │ │ │ -BE2C8A13CBB20592CA79B73BC4E3E8C59817EA5B6D7FC3E57CB383762C8DFFCB │ │ │ │ │ -564756E8CC7B881E92CC5CA8CE257A51E9AD78A2D7D259A241F1D79D4958773C │ │ │ │ │ -87CFAD8FAE10B7A22768CAF6B08349C750A53B942C72F9B53FD4B7B6CCA02301 │ │ │ │ │ -F96218EB1C27D96FA4E661127A7F97646E7562EF63641D59E04FD47B64D57DB5 │ │ │ │ │ -90C42993033463EFB67A4594285E5AC26E361E27FD5605C11CA3D335BDF9EB20 │ │ │ │ │ -01EA8B5D0B1309993CF152169E7189D1188B71FB65CF0503BAEFCA6226435F57 │ │ │ │ │ -5DD0DED405DB28C75FAFBD1EEB5821B58A4F4E741ABA9A3E679F93E3621936B2 │ │ │ │ │ -290FD8D271DE2A0E29B87031D12A9573CBB768C40F0E9A404334E3883A27A7D4 │ │ │ │ │ -25D5A859D023F95E71A2A3C2CE25E63BD552A35FA2A8F9F79792E37024D57DFA │ │ │ │ │ -19E58EF5BAA59586AC841725AA3ABE8FBDC96D7CA86C2C41FFCDDF6BB92E324F │ │ │ │ │ -1C2CF728CFAEEAE0E3376ABAA9C79656F308C5833DCA1C7729D10A8E8960C294 │ │ │ │ │ -FF7D18D39A3B5CA2C894C2BD0401740C0EE1650D12FF3CE873F8915D34D7E92C │ │ │ │ │ -E3AF3C20E1C5501198BEBCF9034CB914717DEA891BAC52D515EACD104F925DF6 │ │ │ │ │ -8FFB4D74CC72332E0887E1E5343B005AAE19C60AEF32581F8FEB1ECFAE547FDC │ │ │ │ │ -8EFF5A31897895F294282B70D8F720F9C711FD161F4BFF7BE21E907568855411 │ │ │ │ │ -703B464CEFE5D309221F1221A263E37E72D85039C60508FD557702DE299BB1D5 │ │ │ │ │ -C87F6C1C82994EDFC840798ABB551E9AB4A4D45BEF55C16E825BF0E4C67C782E │ │ │ │ │ -D1DF734BB3320630C545EE373865FE61C1A09FAF288E62FD6FACDE4F906B736E │ │ │ │ │ -D0B1895590737E0A9370F8C11A924750234406C6F7039D0887B6CCC26B36E924 │ │ │ │ │ -844D959CE9C4F7B15BFFF4B2BA881209D8EB11D263CBE2C8F49534F7E502A9E2 │ │ │ │ │ -5938DC3202F712D4012A29BCDA21627FD9561B33A6E0678DCB9294C3053DBC66 │ │ │ │ │ -A0ED0D695DAEE30DFF518E954BD6234E2B504D7A6AD4EEEB3919B940AC1016C5 │ │ │ │ │ -59C2D65D2587EBAC5D9232ABE11CFD24D617111BA3D00DB3A3ABEACB03F6B03C │ │ │ │ │ -CE854938B79D483757C1C9B26A91DCE4D0C90BB38108DD8D9AFD91C8C76A33C9 │ │ │ │ │ -4CFD33F1281A986EF4408D299F5B66CCF372CD211DFBC15E27DCC8FBF7218479 │ │ │ │ │ -12734BAF786AD5E3F711480AE93F7535F06034DE8F9CBBF0712EE018CD4BD16B │ │ │ │ │ -E013D97DD3AAD0BDBA7B88DC530EEFB23A2592250B31C248BD594305CA04826B │ │ │ │ │ -C72D7A7C53C1EA047C64AC59375B394B859A901A569C850311BB44CA769CA424 │ │ │ │ │ -1A0DB33AE15F647CE562BE3C3A8CF4DCD7EB52D8E285165902FFE33C980A5565 │ │ │ │ │ -65C712D5B1F680DA89B82CC79D5B038C9E827E7DBA9A12D3BB235E5F4F687894 │ │ │ │ │ -5FEEC83F49C905CE5E79B7624E22F99CA6D6E787D0AF4CAE6DD0306B0E7825CB │ │ │ │ │ -B85161DBB393AC5037451E07527794D2B8E5 │ │ │ │ │ +818321B3C46DB51B8EC6C2EF1D05C716519A3BD6B12A67239898F8A011FF0A90 │ │ │ │ │ +8475178179495771FDBC888A3F3AB7D4973FD40161ABF4627F4BAF61516F52BC │ │ │ │ │ +26D71703BB51A3B52A173197A86B8683132FEA26BC23A46914E1D3889F898FED │ │ │ │ │ +5A3D0FEF13717D5CBBB05E3330B2DD7661706A637F8DA473E4722353D75BF170 │ │ │ │ │ +449D32531963F92BA9D7AA403D4B8F19416A9DB6DFFDFAF13FD128044D1B5F69 │ │ │ │ │ +43412B27FA2CEEA41103A485E5F78D6906218C078BFECFA1E878CCB4473B078A │ │ │ │ │ +7373F0D086F6B4FD21EAA407675F629D9558CEEBCBC39CC8DF33CE0FB5803CB7 │ │ │ │ │ +05BCFA9EEFB2FED4539665ED5D6E59E619A0BA23058571CAC683158EFC726FC6 │ │ │ │ │ +18BABBC17242A1C41B585AF89C8D1A1B487B3B15DDF120DDF20E77F440FC6B63 │ │ │ │ │ +3BACFB07845607E1D408BC8C3F3C1AAAEB09D8FAF50F853CDF71D6BBBFAAD843 │ │ │ │ │ +BF8CEAE85C3116DF48AB04637A4688445D298ED7A4E7AA9CF11F73E75A67E59C │ │ │ │ │ +7E68D1F48CA92434257771C7A0676731550F98DE7E2337939FE857CC6358E35D │ │ │ │ │ +AD226415CE508AB95A7480098198BFD871E016234540F9F6E266357C1B33D803 │ │ │ │ │ +B63549034B7B6E79FE2FB6F6723439B72BD64282A882DEB66DB815AD86B85B49 │ │ │ │ │ +AC980BCE9134A920B8822D0FF3B6C30A4C083D028BBEA99DB089D82D9FC9BBCA │ │ │ │ │ +D1E9C6866A25B67550E0DB34DD64BFC490E5D801220F695C18A184BEC473060A │ │ │ │ │ +E9B49E2610C067198EBD39E0614EBB6D2A4E7636CD2F7B009F6952BC47860BDE │ │ │ │ │ +FD79BE6E1C3F476089191EF5C9C72CC5035F390C49CE7E8C64DC2CED43B00ACF │ │ │ │ │ +A947122D5044945D5CCB573CC4315827C09525CD5966D260E34BAFEB68CD6FC1 │ │ │ │ │ +1FB144600E2F48F1E5FCD82809766B3FB4A1C71DD719ED9D69427B27ED1E1B9A │ │ │ │ │ +444797406988784E35FF5DD3B932A4DE6FB56357387D17CA1408271CD205E96A │ │ │ │ │ +55C95F58E452E262B1ED09087F3C976B8AA9B9A0B0BA4977E3E1529D8975B622 │ │ │ │ │ +B720B1630A4719FD497E564402DFA1AAC92E28697E29A000207A626577F0CC8F │ │ │ │ │ +104B4719298B4E094E4F70FEA9D89B449A206107477DEBB5EF80D6E098744686 │ │ │ │ │ +6BD27F9B6CE8166784244E62DACC3F5033C0B48B3954591F6522FDAC2E38D543 │ │ │ │ │ +CF6A3CFD3403E8A06A7055A07CBB2D39CA22A7500BCC5BC2FE844BCECDBE1B67 │ │ │ │ │ +9E1D8C08AE19744238F6F899E99DFC487E70FF36E64AB84E6C090C6F1F9E39FB │ │ │ │ │ +5ACF041208EF74CA150F963EB8FB47A8B5A92302388950D0B93CE473532B27A3 │ │ │ │ │ +60B55E33169E084B92FE25959678A312C8F656B70BD0DE8FFC0E76AD4A7BDD6C │ │ │ │ │ +526C954BC94244618856DAA80BD8ECA8AFFBF25D27CB11584EAAA7B171A6E37B │ │ │ │ │ +0F78DDAFF2426421F0093C60F1FF72A99E4407AA944E8DFFDC66F0447B29D7CF │ │ │ │ │ +1EA5A303F00B030B4657954151491202EC970D93849983D01AAFC07DF77943C8 │ │ │ │ │ +047A7A1F56A06F0737F068F11BDD3437DB652A9671DCC95C0B03DF51E8E15117 │ │ │ │ │ +CECD5A60CCB625BA50F16BCB610BFECD03E520495659DEC4E5644C37EF7F90A7 │ │ │ │ │ +B2D8238251DAC5F0DB59044C936C89557FCE02A9D8CF21F49B9F8E7AC1257223 │ │ │ │ │ +AE02F4286F6BD7DDE33C357EDC5DD0A80978313A3F02801884F52356944DA85E │ │ │ │ │ +C002B2553218383978DDF443702CB03121880D2997D76A12F922CB21E9EABC36 │ │ │ │ │ +2C48AF43514FB7875620E57A545A8729F311FED4C947F95047E3356AF120BA43 │ │ │ │ │ +67A269C30DB4BBF586E58DDA0D74426D7B050B8B1649B2ADC67146942DAFE5DD │ │ │ │ │ +4F09EE860A358A72F13C767CCD5D149BD6BF4AA8813BC342B8693452E4ABFCFA │ │ │ │ │ +2DD8FD01740213FBD40F48F7B3899F95A235D8F2B51D5F29C5438DBFCC4AB734 │ │ │ │ │ +EC2206C7071B71725B782F13DEF3205052F5E21968EBCD4BD27A038028A32B5A │ │ │ │ │ +33E2828F46A409AD308273F25E9133195B068FD7D43A5A640B3B1AE1B754A07E │ │ │ │ │ +C60D53A73D322B1062EC57C955DE9D9B14C25FA8C2E849847A54328E09487B44 │ │ │ │ │ +84F52C3BEBC0241BD3A6DB5B2A4E37CF52C1B9A8250C73AC6FE5C4F5645F47D5 │ │ │ │ │ +0E4D32933B1DE779735A2E9A6A533A9E35F35BDCA4844BE38B0B21718B98343F │ │ │ │ │ +4B347188379E4B59FB42F9B2F32CE47E71EF3D3CC15718CFBE1571CDC1B327BB │ │ │ │ │ +D12CBF2058F887BD9A096CA624E7D9178191F1F2267851F798A81DE5E44254DF │ │ │ │ │ +8F216474F85AE1C4C03DDE4534D5A5C859CB8BB4439BC57D59D0EA5D7F56D241 │ │ │ │ │ +26F609D59AA6A76C70EFB1D67C57E57C7FDBDB6FA74E9902DB8CD77B652C878E │ │ │ │ │ +AEDDC0DD4967D41E22AE5DCF023B75434B252C848F04B0FAC00E87F5BD8ED24D │ │ │ │ │ +88C1A34034F452B92242EB030780A071FA2591150D520160F143F30F38F72987 │ │ │ │ │ +21D3B30F3434E3E14AAF8009E0FECD9AE3B4741C8EA3B0EA399EFDAFF5D7E1C8 │ │ │ │ │ +D3D53F10AEA6B70C647214A73869886462179CDFF53AC05F2D9065EC5A3E0ACD │ │ │ │ │ +13B07DFF43B5BEB7B391F1B5C84AE4D76DBB1A8FAE604CDB79196C68E45C069F │ │ │ │ │ +AB4B973D3625A8A41CDAC14BF159DCA1B527EC57AE950F3623B6B9923B97AB23 │ │ │ │ │ +8DF6D5A575A9D4697D54B0002916EFD1A6A17B6A0EC0105ECC0656DF1AF16DD0 │ │ │ │ │ +211ADB3EE46FE297257F2CCB4A5CF1305E5C8BF92E58BD5436DF3F3CA454A676 │ │ │ │ │ +52F9D2CAB2D0640340B4A948BA2B3A4B9AA91A4F44F61214F2E6CEE3A5CE2878 │ │ │ │ │ +C3860CEA13B28C716B66015861E10F77A79D36379279FD78F0DCE428979CDFBA │ │ │ │ │ +B5EF56882A8F5ED0A30F1932AB155F7358128C23D9429A1CE46D48C3C41B1989 │ │ │ │ │ +22D59495ABBF1EB63C4C8F53C3EC3613EF19C9F4A364DFC39E454F51DC96E4CD │ │ │ │ │ +751DCAE9C0AD9E52FC71053F3A1BBC7A3FD75D244A1DC3780024A9FB34EF3FF5 │ │ │ │ │ +343443A927ECB8FDDAD61F7F368221C092A27E1DEBB8AD71AC922BE06021D129 │ │ │ │ │ +D10E36920C8081DBF9CB3AB7EC7A54EE6E66F01DEF1AA810CC7FE470290AAFB1 │ │ │ │ │ +B5D176649521F5AE7EC965E4B062E0275E66EDF5B7CEE5D279A47896DB822FAD │ │ │ │ │ +D296CFF1D1F31226E7300AEA0A3BEA7D81CC11E0AC4659B6D67CD8F81C6C97AB │ │ │ │ │ +BABF638190175323786E515E31511A73311F23C6A2FA8DBFC90C5FD7E98DEC9E │ │ │ │ │ +42D05830D270EE8387E8EE320115EB9118DB4054CA2902957EF50C5804808CAD │ │ │ │ │ +24FFB5D67500B9D04DD531494A933003A1AE280CB5E5269BDC7BEDF5B0749C0B │ │ │ │ │ +C5AB21315DF45339157AE76674293CE7D13DFD999A64A808B98C88A25DB77805 │ │ │ │ │ +516A64A8E1C8D6726E1AA04BE15CE83B5B3DA250B912D85295D322029A8C6017 │ │ │ │ │ +D1D16912B55864B7CFF4BE7CBBC94042B4B44E662790D07C66A071BC55A35EF2 │ │ │ │ │ +5194B144FE5E8680F891205E67BC793403AF30116C9F41C62C517E66E6D0ABEC │ │ │ │ │ +6665CEF18947E5A8E2B2AA4BAA97C01188ABA1F0098FE256093F922B640B71ED │ │ │ │ │ +ADB20A3C2F14AC1146754BCC7B2D90347FEE5CFA917F94A85A53F2CD567CF6E3 │ │ │ │ │ +F80A29CF46DE1DE011F93DB69C7FCF23DBA1A9FA875AAE9045E3189D50DB19E5 │ │ │ │ │ +5A26F849251BDA2580EB3D740E819C4DA2426244B5C7698BD8CD53D6C911FF4B │ │ │ │ │ +D42C0534A853CA8FFE411B69246E1B040693F2DEACAC5B5C86ADF4B46263C07D │ │ │ │ │ +7E958610A38599D9BB32F7B3792CFBC5B36A653D2FBF9431E79B6D7433613F6C │ │ │ │ │ +D9E5142FEC781425E61DD54B0B8D2DF73B7CD89973F8CFE6B2A8F911C7D20ABF │ │ │ │ │ +4FF04D060A77CF1CE4B9BB85C23CF30CB649C42403A604DDEEC1662DDEE79943 │ │ │ │ │ +D807C7ED8DAB720A3D0541855596FDFA944F2910C373C9286931051B5775B332 │ │ │ │ │ +60118FD70DCE882054E0EB17013BEFA7554B5B3EDCEA2BD0B5C864FEBCDD92D4 │ │ │ │ │ +E4FD24149D14D04D075D9F3A0D1F5F75BB1E046EE8B14D610D866BDE941565D0 │ │ │ │ │ +29CE570DEE476BB901019D1139FC8FC1F3411A0D3BC68857864FC180A93732AF │ │ │ │ │ +9584A134E4BEBF4954BD32DDDBF647D490D1309C8AA7CFAD176A9473746619AF │ │ │ │ │ +7D7840339955325265C0D5C9EC25AFDBA2020374F6B8DABAB8FAF5A54441452B │ │ │ │ │ +7242DC011124560D708CAA11101AF34FF3C28F80E0B10EB5980ED9B4A956324F │ │ │ │ │ +ED41FF51E0F6EF78DA09651CFE1480E5115C288D177A61B8E53892E707D6DA15 │ │ │ │ │ +5F0BA7E669D2D5F80F6F00FF1702C8C740CA720DE01E8CB37DFF4C9F88385D3B │ │ │ │ │ +987E2D8B064E2E7F8A13A278DB8B41C59A942798F291EF6D53640FDC95D618C3 │ │ │ │ │ +BCF0E472308F1BB4C2E1F6B192DD377563ADEE569B2C7F23C57A2C380B237005 │ │ │ │ │ +9CE364AF5EFF57FD85C6C843194765C4547B8B0C7B6BB514813CB04E27F4F39F │ │ │ │ │ +C294A3AE5241B8454597424621755989AC23964524ADA65C250423463D7CDA8B │ │ │ │ │ +7F259F647C21D5F87D86B25EB45F533B35398C5837AC71BC04510CA578EBBC23 │ │ │ │ │ +1D1DA9489BDAFBFCF55EFF0F7C492E09DE3367B6B29ADB2FA51E327F57653E44 │ │ │ │ │ +64249D3020AB1CEF4E846081661D4BF215FDC1B96836B04311688522560D2277 │ │ │ │ │ +31EBDF3F26257C8BC38EBB6FE8C7B1F8995248695AF16B4BF74B0FDE8D83BC29 │ │ │ │ │ +729B450D59181E5033BF90478DF1B3289B30C9F58F514755698374597BCEF907 │ │ │ │ │ +1F341BDBF2FA20664E51F77EF20E8BBF203C380ABF763641A94C81D1FBA09D2B │ │ │ │ │ +CF425A87FA2E6625A4D2F9E832E944ECED416DBE5AA9962F2204F7E14162F6E4 │ │ │ │ │ +81DE39D13BBFA7E743CCC081E1C54B357BD1CBF9D0245DA75E65AA76B7685FAC │ │ │ │ │ +AE88F563730CF7BFEADEF4A2B28EDF8C987A775372290334969E938700D5CB56 │ │ │ │ │ +36BB154C524B5CC206637E2FCC77DB5016DD3121B1044F6A6EABDC8600590B27 │ │ │ │ │ +A14B5DFD3103D72A6ED4F3D9E74691AA6321B62C59A2358C5774C4545C3F530D │ │ │ │ │ +57365FF66A2611D5AEDF5E60DD6231AB444B907635003FB46D46BE346577EB8B │ │ │ │ │ +3364B9F74DBA7B6B880230D5AAC1C9255A9EA9512F945AA530D0A10AFBB931FD │ │ │ │ │ +5C364996F354AB1F37A391A56E25762B26A0BD891E3211B03C61D3574418AB9F │ │ │ │ │ +736331B5081427F069D4642D4A2B1EE5E627AC6F258251C457A19B80A1CF2B8A │ │ │ │ │ +F5259FFAAE691E8FDD15044CF2F063E995511E0095B5E65F850B75A1921870E5 │ │ │ │ │ +5D277363B149330CE6B14B62977E8C4C8F85834C2D56C8C0A65B0E3E4E9FA347 │ │ │ │ │ +0733FE8EC43DDCCDB92B095232BAF535548FFEC22B2BA5E6591B4AEED54EFDFF │ │ │ │ │ +2852A43942D85C201C82800697925F0909676B0F51133034882C7EC50271156B │ │ │ │ │ +4EDE20831BA154B227523937601518DA9C70C0BCC4FF774373B54FC19A8C6CAE │ │ │ │ │ +29477ED15AFD4E0ADF93B7BE6D2A11F6E1C850F2AE4F8BA06CAD3EBFC666A090 │ │ │ │ │ +79D561ED7BB1B38FBA27D7F4E702DC317BF2DA9E71B0C977BEE2D59AABB9FEB4 │ │ │ │ │ +EA25932FCB5AF69F0B3D73F42EDAF21C26E10E43521563BC501BE864003FCCB7 │ │ │ │ │ +730A625DA3840BF2A29685C83956AEEE40551B7BA8256D5399DC6ECF16BC46BB │ │ │ │ │ +DFC431920198A1B62852B9023C987EF144EE257D6374A04541CF62E379AD93C6 │ │ │ │ │ +E79ECD3116FE9D44D9191D68526285D6C52FAC963FCF04000134F2F56CFD8A3D │ │ │ │ │ +F9C5451FFCE42DB27BE7CA75D1CA600FE64CFCC153D10886718A7671E06432FF │ │ │ │ │ +0B42135A5D206075A9B85F9118BB6DF3DB5FBDB344C7AC59ED9C8E16D7DC55DF │ │ │ │ │ +0D801D30B1357C3432F14AD553412F5DE3855AFF33AE594D6813841C4B6C558B │ │ │ │ │ +29D62493D9BA8162C0338B4324D75F51470D3404E6F18DA68272A0EEFA7F16CE │ │ │ │ │ +987F7CFA040C39012AE793D5B710D38A84158725168481524F122DC7309FF129 │ │ │ │ │ +C7F4CA12AFAC300322CAE5F6EC4CEC42FE12422B3EC36EAF2FAE448F5442BC34 │ │ │ │ │ +7C9CA55490BA171AE1342DDFF775E7332DE287EF4848FAF65FEBDAED62CEF1FC │ │ │ │ │ +C28A44042414D864768EB893AC812F6C1CA91DAA633F1E81DD1819F99FEA14AD │ │ │ │ │ +6ADD23B3840C1228018E96F57BF9C1A71F2ABFF02BFD57BD03FA2D6917152401 │ │ │ │ │ +754AA0FCFDD9DA1E836A62ED2C64C1B55077A5B982B3BCC6A4E68D3317BF3E0E │ │ │ │ │ +23C1AF4FE17F0B48BCFB951DCD31B0A642611E0FA53AAA70E8F6A3AE768C3193 │ │ │ │ │ +F3F267BB37032F88113ED1A4F411FB63F80118F153ABAD7378A8CA6031F67A9A │ │ │ │ │ +CC312A60E855332290B5D18D0D6432F6A23E4D20B7054B42A184321B12B6D11D │ │ │ │ │ +CA83224DD53C0BA1D8DF4AC5710E8E1BDC573468ED70CFD7962CF47CE89FDFE1 │ │ │ │ │ +DC1AD28FAA2FF52F84E16C930886C68CE70854AF9F808B196CEAA3DBA442DD15 │ │ │ │ │ +BA4A1AA81D9229C8ED955D7E2E16BF80E28E3035136C1564BB14AC7C846B45AF │ │ │ │ │ +3A564E5337F2320EF623A39F8E9548EEDA9648AE8777562C99772E58E38A459F │ │ │ │ │ +70C724177AFA1C7BD8BC9D6665EC7E9658D00C132B7121FBD8C752BF24FCDEE4 │ │ │ │ │ +923F7FF4C869F69392E3FE205961BA209E81A724F48553163F7966F2B8CE671F │ │ │ │ │ +9B52876A4AACBCC6C93C4C40D522479DB2EB7D3ECD052CC2C2286FEC47B2732F │ │ │ │ │ +9FE9477BA4C5404E5AB64AFAEA4C3402FBDFCE721670864D5C4DF7424D705D7E │ │ │ │ │ +F6647BCA607344330873EDCD0F2CD3E6A61404EA9E129094B0576F44813363FC │ │ │ │ │ +3CA9280A14BD2CDA7288AA75920D7A0DB9370A092386B91373C49A6A41380904 │ │ │ │ │ +BA4560339AF68E8E31D2F32683CB577332D44ED62B8797F5B6D1765B03ACAC09 │ │ │ │ │ +4B887439FE225F036AC09C7D0CE9 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ @@ -4972,22 +4947,22 @@ │ │ │ │ │ 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 │ │ │ │ │ /Fg 203[30 30 30 30 49[{}4 49.8132 /CMR6 rf /Fh 133[31 │ │ │ │ │ 37 1[51 37 39 27 28 28 37 39 35 39 59 20 1[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 45[{}45 │ │ │ │ │ -66.4176 /CMR8 rf /Fi 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 2[89 1[76 │ │ │ │ │ -50 5[75 70 1[73 9[49 2[49 1[49 49 49 1[27 1[27 44[{}31 │ │ │ │ │ -99.6264 /CMR12 rf /Fj 172[90 2[110 121 2[97 6[106 69[{}5 │ │ │ │ │ -143.462 /CMBX12 rf /Fk 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 │ │ │ │ │ +66.4176 /CMR8 rf /Fi 137[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 11[49 2[49 1[49 1[27 1[27 44[{}27 99.6264 /CMR12 │ │ │ │ │ +rf /Fj 172[90 2[110 121 2[97 6[106 69[{}5 143.462 /CMBX12 │ │ │ │ │ +rf /Fk 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 } │ │ │ │ │ @@ -5000,17 +4975,17 @@ │ │ │ │ │ TeXDict begin 1 0 bop 407 1704 a Fk(The)44 b(Reference)g(Man)l(ual)f │ │ │ │ │ (for)g Fj(SPOOLES)p Fk(,)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 Fi(Clev)m(e)35 b(Ashcraft)1004 2423 y Fh(1)1297 │ │ │ │ │ 2459 y Fi(Daniel)d(Pierce)1864 2423 y Fh(2)2158 2459 │ │ │ │ │ y Fi(Da)m(vid)g(K.)h(W)-8 b(ah)2774 2423 y Fh(3)3066 │ │ │ │ │ -2459 y Fi(Jason)33 b(W)-8 b(u)3485 2423 y Fh(4)1664 2725 │ │ │ │ │ -y Fi(Ma)m(y)34 b(17,)e(2024)104 4280 y Fg(1)138 4312 │ │ │ │ │ -y Ff(Bo)r(eing)70 b(Shared)d(Services)i(Group,)79 b(P)-6 │ │ │ │ │ +2459 y Fi(Jason)33 b(W)-8 b(u)3485 2423 y Fh(4)1657 2725 │ │ │ │ │ +y Fi(June)33 b(20,)f(2025)104 4280 y Fg(1)138 4312 y │ │ │ │ │ +Ff(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 Fe │ │ │ │ │ (cleve.ashcraft@boeing.com)p Ff(.)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 │ │ │ │ │ (Program)g(Common)f(HPC)g(Soft)n(w)n(are)h(Supp)r(ort)e(Initiativ)n(e.) │ │ │ │ │ ├── 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 │ │ │ │ │ │ - May 17, 2024 │ │ │ │ │ │ + June 20, 2025 │ │ │ │ │ │ 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. │ │ │ ├── ./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 2024.05.17:2218 │ │ │ │ │ +%DVIPSSource: TeX output 2025.06.20:0450 │ │ │ │ │ %%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 │ │ │ │ │ @@ -1199,22 +1199,21 @@ │ │ │ │ │ /UnderlinePosition -100 def │ │ │ │ │ /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 49 /one put │ │ │ │ │ dup 50 /two put │ │ │ │ │ -dup 52 /four put │ │ │ │ │ -dup 55 /seven put │ │ │ │ │ +dup 53 /five put │ │ │ │ │ dup 58 /colon put │ │ │ │ │ -dup 77 /M put │ │ │ │ │ -dup 97 /a put │ │ │ │ │ -dup 121 /y put │ │ │ │ │ +dup 74 /J put │ │ │ │ │ +dup 101 /e put │ │ │ │ │ +dup 110 /n put │ │ │ │ │ +dup 117 /u put │ │ │ │ │ readonly def │ │ │ │ │ currentdict end │ │ │ │ │ currentfile eexec │ │ │ │ │ D9D66F633B846AB284BCF8B0411B772DE5CE32340DC6F28AF40857E4451976E7 │ │ │ │ │ 5182433CF9F333A38BD841C0D4E68BF9E012EB32A8FFB76B5816306B5EDF7C99 │ │ │ │ │ 8B3A16D9B4BC056662E32C7CD0123DFAEB734C7532E64BBFBF5A60336E646716 │ │ │ │ │ EFB852C877F440D329172C71F1E5D59CE9473C26B8AEF7AD68EF0727B6EC2E0C │ │ │ │ │ @@ -1395,72 +1394,64 @@ │ │ │ │ │ 7CA1534C4D5B05FC33F83790ECFD7641DF3FB94289E2A1F6E7D29AB1228A867A │ │ │ │ │ 6E1EF0E9C6F899B491DC18401C2C0A05FFFED46A72C245F7529B8EA55A038082 │ │ │ │ │ 8512307217D2A233C37004085BA3AEE379269F9FA7D0ADB4B19A95CC2AFE686E │ │ │ │ │ 55D88E47257C1FE6F235FEA295910569FE6DD5995512562359CC821E85A6C7A5 │ │ │ │ │ 79B470A9E340A6985189FF8B6AF914A6B0ECF93F47903221F95DE894A8F05B05 │ │ │ │ │ B7D99CD533EC5F931B18E6B39BECF67FA2D6DD1AEC76772B068BE06335A94C05 │ │ │ │ │ 7A4DDEE77B66101DA855C17AC312600370B34E31F5EC3A01300A8EB60B4C9767 │ │ │ │ │ -1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004B9BA1CC │ │ │ │ │ -580D3C6BDA4DC1B80B4365F1C80512453FC5316EC2D928FB731C3D6403E3C18B │ │ │ │ │ -E8424D644DF5E9A2134229C5C91CA68DB8E85BA2BB40F538F585DA6FA4037718 │ │ │ │ │ -B8053EBBA1E765346BCD5BDAA6C38115D31611D8A87A2238C145F2DA2F92E4DF │ │ │ │ │ -3987BD9C4D2A3D460E8941A68B125BCD9EE4F9FD262C4C8A71F47A2C81975635 │ │ │ │ │ -F1B981C274C53FA2ACCDE4C9D0A7C62D6C1EFF91CFC6712CA6A9F333C9564FCB │ │ │ │ │ -2A70F0AD715A79B10A08AB069E2A3C93BC0AED19D0CA10134B8DDDE8AF548DB2 │ │ │ │ │ -3A4AAA9C29682CF135BB767DAA16169A127EB50A7EECEB6480CF56A7D0F8AC56 │ │ │ │ │ -4A5090B3D75A790372886AF568D94C8165975A05BFBFDF1FFBA45F70700BB9E0 │ │ │ │ │ -57F3249EF9E9C8AD9CBCF6E4FD592DC4CDD2CC7C0BC3130C1059096C657BE453 │ │ │ │ │ -A2CBACE93420210E27AF56CA229BD6D982FB68B3FDC6D44478B922C4231C47EE │ │ │ │ │ -E500232F6C11D92DEB955F66DF52B92B22E7352790CC2DCBAC53965D57AC2920 │ │ │ │ │ -68B7D520DE25047146EFEB06B9AD4E2A94243C7E5239F0BC2FC312B16051D52C │ │ │ │ │ -0B92C217B6B42997321AE4F8BB066754B7AA3F15069EF59224E8A442CE471AA7 │ │ │ │ │ -E8049A3DD9EDA09CCEE4998998661CF7DB35E952F6C65DAEB3013951C59F3E09 │ │ │ │ │ -157F313B0237876E1C0190F0473819570B8C0205AADF05D787CC00979CFB327A │ │ │ │ │ -289382B22DDA6F12804ED0ED5B179E36A995A2A59E1B66E75130DBE9109C813B │ │ │ │ │ -94403E0DEA8314A1E9DB474D7FA83C0BAFD08033E6A6215844C1D26BE15F1251 │ │ │ │ │ -A1605E8DF9A9C601ED37379530BC1C82BE5463C6C711C5652BFD6262485AA9CA │ │ │ │ │ -B8C4A117593001D08D980041E2A83C190DCE8E6CD3D334E5CC19FC05DB30F7F7 │ │ │ │ │ -24A305C4DBB31F0651392B99D44B4302333BDF7E326FD256DD75D309C6E73F85 │ │ │ │ │ -FA71B35FD1F9BEFF4C7A1076362EEB0A85492933B6006086A7B8C1928CF2D1EE │ │ │ │ │ -FD4344409257BB802C117E739960821CD3C88BFBA5669FF16F610AD638AF3677 │ │ │ │ │ -8674C985E6767253ED5769F71BEA5E9BB02A751F9E62EE2B18AC19D975FDEAE9 │ │ │ │ │ -8B8822367FF177A7E850766DE99ED3366D46464612926430012212A90F8E85F4 │ │ │ │ │ -4760B40D5B86B90819EE410382C23E86DCAF4F0FF5DFEB2C285965F4DCF2FB2B │ │ │ │ │ -457C0A0427A8D4ADA514E9DACD0F9367E1DA225DB21DA4DDAE33F2B529686D92 │ │ │ │ │ -AC085B345565F9DFFA012FD494DBB2E0B44A0787B2B72DC8D25399DAAE8864B7 │ │ │ │ │ -E84AA99DAFCEAF18F8B41882720316450F1B1CA48B418C9736E5CE4AFF996111 │ │ │ │ │ -5F7FE80958B6A3498508E9693CB134402D92E30D4C2939070D4647E13682290E │ │ │ │ │ -1D0820A3FCA7147157D09D1A40771F214EAE7DD743EA26839E535CA186C05CB8 │ │ │ │ │ -4874988AA1104D85AF0220FE7224344FF624E794BD2454E1C0AC971522FBECBA │ │ │ │ │ -B2497F25CD621B77EC5160973EF5ECC39C183DC051B0DFCB090194A2525BD96E │ │ │ │ │ -28593FDA80D8D259F039416D5F9AF0AD3C9A105B49DAF6E681921E369B7666C6 │ │ │ │ │ -2B73DB37447B00AE96317C2F1C44FB6E6EFD740BAB20FA03A8CE018EC8415582 │ │ │ │ │ -FB06E88A2971E3A480FB1EB4FE93CC7E5179721CAABEE88742B13CF0405F49F4 │ │ │ │ │ -945E587668C821D8C06D6847B6DF84CAFFCD4628670D551FC5F7236875BE1207 │ │ │ │ │ -634BA7F70A19B658FAE7D86F6D00ED28FBF29CC585DEE279325EEF8B0CCB6149 │ │ │ │ │ -E46E638C73D75148F18A636DBC2DD96ED34F68A5A09A3700B1EA34B2D142807C │ │ │ │ │ -F8709D81180783548EAE6F457BF968602076A1069163E3C15BBCEF659C6CF2E6 │ │ │ │ │ -0BB01BDC8E503802CC7969A5B8477E9788C5249B23B19669F5075E089738E49A │ │ │ │ │ -8671D7C1B1B47652F3D78BF2FF74EDB44BA5B092E8D5B85001E97F69D54AEEFC │ │ │ │ │ -88FC3CA1B0D5BAC39263B371005BCFA19AD197A31CC34D0BD55C2CA18C60C485 │ │ │ │ │ -5993F736EF1DD2C5D2B4D50B3D498861B4DF5E7AFF614BBCA4C2E6BECC0DCEF5 │ │ │ │ │ -95F0D686188014C530D8E37650CDCAE721B4AFB0F178BC744BDDDED45DAB7FEB │ │ │ │ │ -A10B975E26099E3DC61116D6BF554574F948895B88EEFE03DCC5351190836AD4 │ │ │ │ │ -EBC1AC55C6D099A8E7B0A372D290C481F44FA464B9C11A0BC991CB045E0AAAC4 │ │ │ │ │ -5C73CA43A4F17D1ADDD33D1B917FF95BFF411C8409F41553B1BC97DE47E3A1F4 │ │ │ │ │ -A5C1D1B7B1BF7E2507AC53956C141411F4F657E37981996DD7BB7ADB2CB6AE01 │ │ │ │ │ -73D0876B8F896F626D5022FE53BA34D5668BD698BE8D5CCAD083CBCEF440BE6A │ │ │ │ │ -8090EB1CDEE5F99C8988650BD4E539B357C31C597D8A9104A9D5967D4E906CAD │ │ │ │ │ -2A65575A884B1C5F6CC509E742FA9DDD66494F219178161AF72C50848E226A95 │ │ │ │ │ -A8C247FF9FF0BABD073021271B5C0692F9BE220071DAB09E5A026629371EE3C4 │ │ │ │ │ -A6E4FA94625D87A5B66EF077ED54C72B1052AEAA9637B30C76EF8EB04AD5F476 │ │ │ │ │ -D15F1C93C0BC6E0F67B366097BBED03FE82C040F9EF02866159B46854E11D44F │ │ │ │ │ -54AE6748A7E61B993A4EECD3B8BE3B5897A66BBCDFE24F65BC2AD5AB49048CF1 │ │ │ │ │ -647203823F84DF5CB483096F9D96AEE3A2855E479B72A14A67C633CE99C101CF │ │ │ │ │ -EFAE939BF9B02E710D │ │ │ │ │ +1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004ACD1870 │ │ │ │ │ +A5EA947858F5795870BFE1343AD803FB854BF8F5A4E794E8EC57BE41DB5B8734 │ │ │ │ │ +13E47950F29A81EA0C81EA798863883D7F41F78325CA190CBBFFE822AE494550 │ │ │ │ │ +4BE83703071FC9512D128927AF3F63CEF8F86ABE1E15D7B4DDD39576E7DFF45E │ │ │ │ │ +3CB4115AAB1830DE8647B915DB4BEBEB5235C281E098B899BAB951D8D5798F01 │ │ │ │ │ +7F7C47336D31438E5126738AFEAB29E9A7CBE06DE4DD604477B542D2620DFD58 │ │ │ │ │ +28FE34238572F23C5A8EB7ACEE1E154DA13FC1A5AA67A3BA8C5CDFB2B80312C9 │ │ │ │ │ +BC9FAE56D08DDFA9498E6EF0D0F6BD18B3923E0B670B0740528BC843610736CB │ │ │ │ │ +80228C105C2F72C3C22D610C3D8C268DEEA2AEEE3221E198E79FE2966487360C │ │ │ │ │ +84AE08AC326F48B21447652121B1EB68AF856055EEA65B6B625BF622CBFC2D1C │ │ │ │ │ +EF943CC4CAF2C715782C9EF9A9BA4689BFC6B6A82F8D55795BE8111E2C7DE520 │ │ │ │ │ +367362304B6A48186C842033E715A46265A352472F4F7313248EBCD26BEA97E7 │ │ │ │ │ +B814A61D4B7ADCB5C5F21AA34E0C1269E8426DBFB511DE6E26B960456C8F8520 │ │ │ │ │ +5F0DD382289A62AF0B935EDB5B2394538C5F0EE72962D2F98F3C38CD7C027B9F │ │ │ │ │ +E230E67E40FEFBDED06B3423C9DFD669E6B5BC913E0FF75786A64A6C11D4FE89 │ │ │ │ │ +1B918DC0E953C52CFD153063CD0D2A78B43F8712243845E6F2CBA1DB610F403D │ │ │ │ │ +A98D06D95FF44C7AC029092B666A8B0DCEA95B34F5ACC10E8611BADE6A24469C │ │ │ │ │ +0C01D95BFB445FA22CD38D033E4D24E006BB9D54EE41EF7AD5AC9C299721F61A │ │ │ │ │ +F01B6EDCDF428BD9195A13C5B1027358F8A203F828A1DD9622243B2D76C6F1BA │ │ │ │ │ +9F2D7E9D4879FC668ABC750CD25415DC6CCF2257C28F78D3F9BE499CC0FF2F80 │ │ │ │ │ +2C2CD1DEFABD6668FCA76E1D629A344333E33DA24B86D2E9F8F5EE1C29974640 │ │ │ │ │ +C3E78E999BAB313400041DADDDFDBFFCC419F129A84F4D412B79E8BE4511CA00 │ │ │ │ │ +F92A4F3CDD2E51345D3965C104F06B6503445DC20224CB7606A9D7D5F9EE45E6 │ │ │ │ │ +1B2963DA96AA2AB1BA5BE29656E666E4D0E122DE58EEA68E04ED76438DA03E65 │ │ │ │ │ +B80055A86B7B2A26BAE6BBB8835E17F9696E9B3CD34571BA75C76D4D2CCC48F1 │ │ │ │ │ +7534C1EF9127E374D65D05B8072E08D6C72A0B4A35EA0DD717743C66D105CCD8 │ │ │ │ │ +7355F13E9C38C1A4351624E689ED7909100942FA0474842EE44DEC3279E1A1CD │ │ │ │ │ +8064666EB845CA7C3E906B67C0BF96A28D514DB2E4A1E4AF287350B03762A2CF │ │ │ │ │ +13B18AC3F5D2F3B74A1D50267C03EFB74B888E1D24ABEEA4A885F4D0BF14C0D8 │ │ │ │ │ +289AC79D6D98E2A2C831672FB1F3457564CD161ADC3AF610D88201AB5B0C10CB │ │ │ │ │ +5ECCC2D5C4AF39C8CB3044BF9EC791BA45D29C2B51EA0483D19822C264CE6FA3 │ │ │ │ │ +5C97F2DF5A78CB93528E99B9ED7CB121C83130C129B849B52A36EBD88AF19DD3 │ │ │ │ │ +C5CABE831027388EF86BD5CBD90AAAC089775938A321C44D4DDA67A51312D8AB │ │ │ │ │ +C509DDBE7044A107AB2BE9C4C9556F85C529B174A7778B489BF28EC07A834542 │ │ │ │ │ +8B31F2925C21FB2096877711F998763D5A8495002B8E080AF8DBB1B3106EDDBA │ │ │ │ │ +35121D52E0846A7AF3ABEDF87BDE4FA665673A9B80CA538B98F873947AA17EF4 │ │ │ │ │ +9BB182917E9D79BC7EC681E93710D6A1D6B0E4A7FA9452FC1C431808174F3AB7 │ │ │ │ │ +F3914FBC86CB34E8583457243C3C7BE4BC166C7397689BC6FFB82EA2967E88EE │ │ │ │ │ +464F96EDA144DE2B64401B8E577ABCA2D826FE0B92E21FFAE3E81EBB6B6EB36E │ │ │ │ │ +9B1A8FE3884CA398C03135FD49D51724FC1268E9482E41FAEA2FC6C809006B8F │ │ │ │ │ +5D4F9E038450AD3A6041C16FD1C7E5FC80C0E033CE57E64863E014531D94DF1E │ │ │ │ │ +31D7D038AFCB60715AA73C1E96F113A24C5AF35BBEB61C4D079ED034ED83AA4A │ │ │ │ │ +E12448E618330463304788BCF40561CD63167B3BF144F408E2B89E60B8BA13EF │ │ │ │ │ +3B57D286FD23D4FA8BAEFF98DC1188B1982956CC1DCAEFC7D949B7B4E3BE8F8A │ │ │ │ │ +BFE2C9D938DD13EFEE7123576608D9396F260907DA98AE2D3DD5822306CBC8A6 │ │ │ │ │ +B083C697DDA3C62EE7879436A9FD8EE0034B105105B3F122F893EA2126EBE8A9 │ │ │ │ │ +5CBF2BD248DD9FBEF0040C25797BD13B69A8C9F0D4E4F935C61ED30487CCDB1A │ │ │ │ │ +0339006E78EE1755929D2412776EC7DB1F666DBDD28EA8AC7397F809C7F38A41 │ │ │ │ │ +5B3BF6C75F4F35C90141EB08377AF452CF840FEA938805F9D14E02DC29215B4E │ │ │ │ │ +F1EB │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ @@ -4830,20 +4821,20 @@ │ │ │ │ │ TeXDict begin 40258437 52099151 1000 600 600 (main.dvi) │ │ │ │ │ @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 23[42 │ │ │ │ │ -19[76 18[23 2[42 2[42 1[42 42 42 3[23 44[{}10 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 │ │ │ │ │ +67 67 2[37 46[{}27 119.552 /CMBX12 rf /Fd 138[46 6[46 │ │ │ │ │ +8[37 26[43 15[23 4[42 2[42 1[42 3[23 44[{}9 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 │ │ │ │ │ /afii61664.cap/arrowleft/arrowright/tieaccentlowercase/tieaccentcapital │ │ │ │ │ /tieaccentlowercase.new/tieaccentcapital.new/.notdef/afii61664.asc/uni2422 3 │ │ │ │ │ {/.notdef}repeat/dollar/.notdef/.notdef/quotesingle/.notdef/.notdef │ │ │ │ │ @@ -5025,17 +5016,17 @@ │ │ │ │ │ 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 1115 4 v │ │ │ │ │ -1280 w Fm(SemiImplMtx)23 b Fd(:)37 b Fe(DRAFT)28 b Fd(Ma)n(y)e(17,)h │ │ │ │ │ -(2024)p 2785 100 V 0 390 a Fc(1.1)135 b(Data)46 b(Structure)0 │ │ │ │ │ +TeXDict begin 2 1 bop 0 100 a Fn(2)p 125 100 1109 4 v │ │ │ │ │ +1274 w Fm(SemiImplMtx)23 b Fd(:)37 b Fe(DRAFT)27 b Fd(June)h(20,)f │ │ │ │ │ +(2025)p 2792 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 │ │ │ │ │ @@ -5109,17 +5100,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 1115 4 v 1281 100 a Fm(SemiImplMtx)23 │ │ │ │ │ -b Fd(:)37 b Fe(DRAFT)110 b Fd(Ma)n(y)27 b(17,)g(2024)p │ │ │ │ │ -2746 100 V 1115 w Fn(3)101 390 y(4.)42 b Fm(int)g(SemiImplMtx_free)37 │ │ │ │ │ +TeXDict begin 3 2 bop 83 100 1109 4 v 1274 100 a Fm(SemiImplMtx)24 │ │ │ │ │ +b Fd(:)37 b Fe(DRAFT)110 b Fd(June)27 b(20,)g(2025)p │ │ │ │ │ +2752 100 V 1109 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 │ │ │ │ │ @@ -5213,17 +5204,17 @@ │ │ │ │ │ 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 1115 4 v │ │ │ │ │ -1280 w Fm(SemiImplMtx)23 b Fd(:)37 b Fe(DRAFT)28 b Fd(Ma)n(y)e(17,)h │ │ │ │ │ -(2024)p 2785 100 V 369 377 a Fm(cpus[0])97 b Fn(initialize)27 │ │ │ │ │ +TeXDict begin 4 3 bop 0 100 a Fn(4)p 125 100 1109 4 v │ │ │ │ │ +1274 w Fm(SemiImplMtx)23 b Fd(:)37 b Fe(DRAFT)27 b Fd(June)h(20,)f │ │ │ │ │ +(2025)p 2792 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 │ │ │ │ │ @@ -5286,17 +5277,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 1115 4 v 1281 100 a Fm(SemiImplMtx)23 │ │ │ │ │ -b Fd(:)37 b Fe(DRAFT)110 b Fd(Ma)n(y)27 b(17,)g(2024)p │ │ │ │ │ -2746 100 V 1115 w Fn(5)307 390 y Fg(\210)42 b Fn(The)28 │ │ │ │ │ +TeXDict begin 5 4 bop 83 100 1109 4 v 1274 100 a Fm(SemiImplMtx)24 │ │ │ │ │ +b Fd(:)37 b Fe(DRAFT)110 b Fd(June)27 b(20,)g(2025)p │ │ │ │ │ +2752 100 V 1109 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 May 17, 2024 │ │ │ │ │ │ + 2 SemiImplMtx : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 3 │ │ │ │ │ │ + SemiImplMtx : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 4 SemiImplMtx : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 5 │ │ │ │ │ │ + SemiImplMtx : DRAFT June 20, 2025 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 2024.05.17:2218 │ │ │ │ │ +%DVIPSSource: TeX output 2025.06.20:0450 │ │ │ │ │ %%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 │ │ │ │ │ @@ -1438,22 +1438,21 @@ │ │ │ │ │ /UnderlinePosition -100 def │ │ │ │ │ /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 49 /one put │ │ │ │ │ dup 50 /two put │ │ │ │ │ -dup 52 /four put │ │ │ │ │ -dup 55 /seven put │ │ │ │ │ +dup 53 /five put │ │ │ │ │ dup 58 /colon put │ │ │ │ │ -dup 77 /M put │ │ │ │ │ -dup 97 /a put │ │ │ │ │ -dup 121 /y put │ │ │ │ │ +dup 74 /J put │ │ │ │ │ +dup 101 /e put │ │ │ │ │ +dup 110 /n put │ │ │ │ │ +dup 117 /u put │ │ │ │ │ readonly def │ │ │ │ │ currentdict end │ │ │ │ │ currentfile eexec │ │ │ │ │ D9D66F633B846AB284BCF8B0411B772DE5CE32340DC6F28AF40857E4451976E7 │ │ │ │ │ 5182433CF9F333A38BD841C0D4E68BF9E012EB32A8FFB76B5816306B5EDF7C99 │ │ │ │ │ 8B3A16D9B4BC056662E32C7CD0123DFAEB734C7532E64BBFBF5A60336E646716 │ │ │ │ │ EFB852C877F440D329172C71F1E5D59CE9473C26B8AEF7AD68EF0727B6EC2E0C │ │ │ │ │ @@ -1634,72 +1633,64 @@ │ │ │ │ │ 7CA1534C4D5B05FC33F83790ECFD7641DF3FB94289E2A1F6E7D29AB1228A867A │ │ │ │ │ 6E1EF0E9C6F899B491DC18401C2C0A05FFFED46A72C245F7529B8EA55A038082 │ │ │ │ │ 8512307217D2A233C37004085BA3AEE379269F9FA7D0ADB4B19A95CC2AFE686E │ │ │ │ │ 55D88E47257C1FE6F235FEA295910569FE6DD5995512562359CC821E85A6C7A5 │ │ │ │ │ 79B470A9E340A6985189FF8B6AF914A6B0ECF93F47903221F95DE894A8F05B05 │ │ │ │ │ B7D99CD533EC5F931B18E6B39BECF67FA2D6DD1AEC76772B068BE06335A94C05 │ │ │ │ │ 7A4DDEE77B66101DA855C17AC312600370B34E31F5EC3A01300A8EB60B4C9767 │ │ │ │ │ -1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004B9BA1CC │ │ │ │ │ -580D3C6BDA4DC1B80B4365F1C80512453FC5316EC2D928FB731C3D6403E3C18B │ │ │ │ │ -E8424D644DF5E9A2134229C5C91CA68DB8E85BA2BB40F538F585DA6FA4037718 │ │ │ │ │ -B8053EBBA1E765346BCD5BDAA6C38115D31611D8A87A2238C145F2DA2F92E4DF │ │ │ │ │ -3987BD9C4D2A3D460E8941A68B125BCD9EE4F9FD262C4C8A71F47A2C81975635 │ │ │ │ │ -F1B981C274C53FA2ACCDE4C9D0A7C62D6C1EFF91CFC6712CA6A9F333C9564FCB │ │ │ │ │ -2A70F0AD715A79B10A08AB069E2A3C93BC0AED19D0CA10134B8DDDE8AF548DB2 │ │ │ │ │ -3A4AAA9C29682CF135BB767DAA16169A127EB50A7EECEB6480CF56A7D0F8AC56 │ │ │ │ │ -4A5090B3D75A790372886AF568D94C8165975A05BFBFDF1FFBA45F70700BB9E0 │ │ │ │ │ -57F3249EF9E9C8AD9CBCF6E4FD592DC4CDD2CC7C0BC3130C1059096C657BE453 │ │ │ │ │ -A2CBACE93420210E27AF56CA229BD6D982FB68B3FDC6D44478B922C4231C47EE │ │ │ │ │ -E500232F6C11D92DEB955F66DF52B92B22E7352790CC2DCBAC53965D57AC2920 │ │ │ │ │ -68B7D520DE25047146EFEB06B9AD4E2A94243C7E5239F0BC2FC312B16051D52C │ │ │ │ │ -0B92C217B6B42997321AE4F8BB066754B7AA3F15069EF59224E8A442CE471AA7 │ │ │ │ │ -E8049A3DD9EDA09CCEE4998998661CF7DB35E952F6C65DAEB3013951C59F3E09 │ │ │ │ │ -157F313B0237876E1C0190F0473819570B8C0205AADF05D787CC00979CFB327A │ │ │ │ │ -289382B22DDA6F12804ED0ED5B179E36A995A2A59E1B66E75130DBE9109C813B │ │ │ │ │ -94403E0DEA8314A1E9DB474D7FA83C0BAFD08033E6A6215844C1D26BE15F1251 │ │ │ │ │ -A1605E8DF9A9C601ED37379530BC1C82BE5463C6C711C5652BFD6262485AA9CA │ │ │ │ │ -B8C4A117593001D08D980041E2A83C190DCE8E6CD3D334E5CC19FC05DB30F7F7 │ │ │ │ │ -24A305C4DBB31F0651392B99D44B4302333BDF7E326FD256DD75D309C6E73F85 │ │ │ │ │ -FA71B35FD1F9BEFF4C7A1076362EEB0A85492933B6006086A7B8C1928CF2D1EE │ │ │ │ │ -FD4344409257BB802C117E739960821CD3C88BFBA5669FF16F610AD638AF3677 │ │ │ │ │ -8674C985E6767253ED5769F71BEA5E9BB02A751F9E62EE2B18AC19D975FDEAE9 │ │ │ │ │ -8B8822367FF177A7E850766DE99ED3366D46464612926430012212A90F8E85F4 │ │ │ │ │ -4760B40D5B86B90819EE410382C23E86DCAF4F0FF5DFEB2C285965F4DCF2FB2B │ │ │ │ │ -457C0A0427A8D4ADA514E9DACD0F9367E1DA225DB21DA4DDAE33F2B529686D92 │ │ │ │ │ -AC085B345565F9DFFA012FD494DBB2E0B44A0787B2B72DC8D25399DAAE8864B7 │ │ │ │ │ -E84AA99DAFCEAF18F8B41882720316450F1B1CA48B418C9736E5CE4AFF996111 │ │ │ │ │ -5F7FE80958B6A3498508E9693CB134402D92E30D4C2939070D4647E13682290E │ │ │ │ │ -1D0820A3FCA7147157D09D1A40771F214EAE7DD743EA26839E535CA186C05CB8 │ │ │ │ │ -4874988AA1104D85AF0220FE7224344FF624E794BD2454E1C0AC971522FBECBA │ │ │ │ │ -B2497F25CD621B77EC5160973EF5ECC39C183DC051B0DFCB090194A2525BD96E │ │ │ │ │ -28593FDA80D8D259F039416D5F9AF0AD3C9A105B49DAF6E681921E369B7666C6 │ │ │ │ │ -2B73DB37447B00AE96317C2F1C44FB6E6EFD740BAB20FA03A8CE018EC8415582 │ │ │ │ │ -FB06E88A2971E3A480FB1EB4FE93CC7E5179721CAABEE88742B13CF0405F49F4 │ │ │ │ │ -945E587668C821D8C06D6847B6DF84CAFFCD4628670D551FC5F7236875BE1207 │ │ │ │ │ -634BA7F70A19B658FAE7D86F6D00ED28FBF29CC585DEE279325EEF8B0CCB6149 │ │ │ │ │ -E46E638C73D75148F18A636DBC2DD96ED34F68A5A09A3700B1EA34B2D142807C │ │ │ │ │ -F8709D81180783548EAE6F457BF968602076A1069163E3C15BBCEF659C6CF2E6 │ │ │ │ │ -0BB01BDC8E503802CC7969A5B8477E9788C5249B23B19669F5075E089738E49A │ │ │ │ │ -8671D7C1B1B47652F3D78BF2FF74EDB44BA5B092E8D5B85001E97F69D54AEEFC │ │ │ │ │ -88FC3CA1B0D5BAC39263B371005BCFA19AD197A31CC34D0BD55C2CA18C60C485 │ │ │ │ │ -5993F736EF1DD2C5D2B4D50B3D498861B4DF5E7AFF614BBCA4C2E6BECC0DCEF5 │ │ │ │ │ -95F0D686188014C530D8E37650CDCAE721B4AFB0F178BC744BDDDED45DAB7FEB │ │ │ │ │ -A10B975E26099E3DC61116D6BF554574F948895B88EEFE03DCC5351190836AD4 │ │ │ │ │ -EBC1AC55C6D099A8E7B0A372D290C481F44FA464B9C11A0BC991CB045E0AAAC4 │ │ │ │ │ -5C73CA43A4F17D1ADDD33D1B917FF95BFF411C8409F41553B1BC97DE47E3A1F4 │ │ │ │ │ -A5C1D1B7B1BF7E2507AC53956C141411F4F657E37981996DD7BB7ADB2CB6AE01 │ │ │ │ │ -73D0876B8F896F626D5022FE53BA34D5668BD698BE8D5CCAD083CBCEF440BE6A │ │ │ │ │ -8090EB1CDEE5F99C8988650BD4E539B357C31C597D8A9104A9D5967D4E906CAD │ │ │ │ │ -2A65575A884B1C5F6CC509E742FA9DDD66494F219178161AF72C50848E226A95 │ │ │ │ │ -A8C247FF9FF0BABD073021271B5C0692F9BE220071DAB09E5A026629371EE3C4 │ │ │ │ │ -A6E4FA94625D87A5B66EF077ED54C72B1052AEAA9637B30C76EF8EB04AD5F476 │ │ │ │ │ -D15F1C93C0BC6E0F67B366097BBED03FE82C040F9EF02866159B46854E11D44F │ │ │ │ │ -54AE6748A7E61B993A4EECD3B8BE3B5897A66BBCDFE24F65BC2AD5AB49048CF1 │ │ │ │ │ -647203823F84DF5CB483096F9D96AEE3A2855E479B72A14A67C633CE99C101CF │ │ │ │ │ -EFAE939BF9B02E710D │ │ │ │ │ +1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004ACD1870 │ │ │ │ │ +A5EA947858F5795870BFE1343AD803FB854BF8F5A4E794E8EC57BE41DB5B8734 │ │ │ │ │ +13E47950F29A81EA0C81EA798863883D7F41F78325CA190CBBFFE822AE494550 │ │ │ │ │ +4BE83703071FC9512D128927AF3F63CEF8F86ABE1E15D7B4DDD39576E7DFF45E │ │ │ │ │ +3CB4115AAB1830DE8647B915DB4BEBEB5235C281E098B899BAB951D8D5798F01 │ │ │ │ │ +7F7C47336D31438E5126738AFEAB29E9A7CBE06DE4DD604477B542D2620DFD58 │ │ │ │ │ +28FE34238572F23C5A8EB7ACEE1E154DA13FC1A5AA67A3BA8C5CDFB2B80312C9 │ │ │ │ │ +BC9FAE56D08DDFA9498E6EF0D0F6BD18B3923E0B670B0740528BC843610736CB │ │ │ │ │ +80228C105C2F72C3C22D610C3D8C268DEEA2AEEE3221E198E79FE2966487360C │ │ │ │ │ +84AE08AC326F48B21447652121B1EB68AF856055EEA65B6B625BF622CBFC2D1C │ │ │ │ │ +EF943CC4CAF2C715782C9EF9A9BA4689BFC6B6A82F8D55795BE8111E2C7DE520 │ │ │ │ │ +367362304B6A48186C842033E715A46265A352472F4F7313248EBCD26BEA97E7 │ │ │ │ │ +B814A61D4B7ADCB5C5F21AA34E0C1269E8426DBFB511DE6E26B960456C8F8520 │ │ │ │ │ +5F0DD382289A62AF0B935EDB5B2394538C5F0EE72962D2F98F3C38CD7C027B9F │ │ │ │ │ +E230E67E40FEFBDED06B3423C9DFD669E6B5BC913E0FF75786A64A6C11D4FE89 │ │ │ │ │ +1B918DC0E953C52CFD153063CD0D2A78B43F8712243845E6F2CBA1DB610F403D │ │ │ │ │ +A98D06D95FF44C7AC029092B666A8B0DCEA95B34F5ACC10E8611BADE6A24469C │ │ │ │ │ +0C01D95BFB445FA22CD38D033E4D24E006BB9D54EE41EF7AD5AC9C299721F61A │ │ │ │ │ +F01B6EDCDF428BD9195A13C5B1027358F8A203F828A1DD9622243B2D76C6F1BA │ │ │ │ │ +9F2D7E9D4879FC668ABC750CD25415DC6CCF2257C28F78D3F9BE499CC0FF2F80 │ │ │ │ │ +2C2CD1DEFABD6668FCA76E1D629A344333E33DA24B86D2E9F8F5EE1C29974640 │ │ │ │ │ +C3E78E999BAB313400041DADDDFDBFFCC419F129A84F4D412B79E8BE4511CA00 │ │ │ │ │ +F92A4F3CDD2E51345D3965C104F06B6503445DC20224CB7606A9D7D5F9EE45E6 │ │ │ │ │ +1B2963DA96AA2AB1BA5BE29656E666E4D0E122DE58EEA68E04ED76438DA03E65 │ │ │ │ │ +B80055A86B7B2A26BAE6BBB8835E17F9696E9B3CD34571BA75C76D4D2CCC48F1 │ │ │ │ │ +7534C1EF9127E374D65D05B8072E08D6C72A0B4A35EA0DD717743C66D105CCD8 │ │ │ │ │ +7355F13E9C38C1A4351624E689ED7909100942FA0474842EE44DEC3279E1A1CD │ │ │ │ │ +8064666EB845CA7C3E906B67C0BF96A28D514DB2E4A1E4AF287350B03762A2CF │ │ │ │ │ +13B18AC3F5D2F3B74A1D50267C03EFB74B888E1D24ABEEA4A885F4D0BF14C0D8 │ │ │ │ │ +289AC79D6D98E2A2C831672FB1F3457564CD161ADC3AF610D88201AB5B0C10CB │ │ │ │ │ +5ECCC2D5C4AF39C8CB3044BF9EC791BA45D29C2B51EA0483D19822C264CE6FA3 │ │ │ │ │ +5C97F2DF5A78CB93528E99B9ED7CB121C83130C129B849B52A36EBD88AF19DD3 │ │ │ │ │ +C5CABE831027388EF86BD5CBD90AAAC089775938A321C44D4DDA67A51312D8AB │ │ │ │ │ +C509DDBE7044A107AB2BE9C4C9556F85C529B174A7778B489BF28EC07A834542 │ │ │ │ │ +8B31F2925C21FB2096877711F998763D5A8495002B8E080AF8DBB1B3106EDDBA │ │ │ │ │ +35121D52E0846A7AF3ABEDF87BDE4FA665673A9B80CA538B98F873947AA17EF4 │ │ │ │ │ +9BB182917E9D79BC7EC681E93710D6A1D6B0E4A7FA9452FC1C431808174F3AB7 │ │ │ │ │ +F3914FBC86CB34E8583457243C3C7BE4BC166C7397689BC6FFB82EA2967E88EE │ │ │ │ │ +464F96EDA144DE2B64401B8E577ABCA2D826FE0B92E21FFAE3E81EBB6B6EB36E │ │ │ │ │ +9B1A8FE3884CA398C03135FD49D51724FC1268E9482E41FAEA2FC6C809006B8F │ │ │ │ │ +5D4F9E038450AD3A6041C16FD1C7E5FC80C0E033CE57E64863E014531D94DF1E │ │ │ │ │ +31D7D038AFCB60715AA73C1E96F113A24C5AF35BBEB61C4D079ED034ED83AA4A │ │ │ │ │ +E12448E618330463304788BCF40561CD63167B3BF144F408E2B89E60B8BA13EF │ │ │ │ │ +3B57D286FD23D4FA8BAEFF98DC1188B1982956CC1DCAEFC7D949B7B4E3BE8F8A │ │ │ │ │ +BFE2C9D938DD13EFEE7123576608D9396F260907DA98AE2D3DD5822306CBC8A6 │ │ │ │ │ +B083C697DDA3C62EE7879436A9FD8EE0034B105105B3F122F893EA2126EBE8A9 │ │ │ │ │ +5CBF2BD248DD9FBEF0040C25797BD13B69A8C9F0D4E4F935C61ED30487CCDB1A │ │ │ │ │ +0339006E78EE1755929D2412776EC7DB1F666DBDD28EA8AC7397F809C7F38A41 │ │ │ │ │ +5B3BF6C75F4F35C90141EB08377AF452CF840FEA938805F9D14E02DC29215B4E │ │ │ │ │ +F1EB │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ @@ -4329,16 +4320,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 23[45 19[83 18[25 2[45 2[45 1[45 45 45 3[25 │ │ │ │ │ -44[{}10 90.9091 /CMSL10 rf /Fe 132[52 123[{}1 90.9091 │ │ │ │ │ +/Fd 138[51 6[51 8[40 26[47 15[25 4[45 2[45 1[45 3[25 │ │ │ │ │ +44[{}9 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 │ │ │ │ │ @@ -4453,17 +4444,17 @@ │ │ │ │ │ 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 1107 4 v │ │ │ │ │ -1289 w Fl(SolveMap)28 b Fd(:)41 b Fk(DRAFT)30 b Fd(Ma)m(y)i(17,)f(2024) │ │ │ │ │ -p 2793 100 V 137 399 a Ff(\210)45 b Fl(int)i(nblockLower)27 │ │ │ │ │ +TeXDict begin 2 1 bop 0 100 a Fm(2)p 136 100 1101 4 v │ │ │ │ │ +1282 w Fl(SolveMap)28 b Fd(:)41 b Fk(DRAFT)30 b Fd(June)g(20,)h(2025)p │ │ │ │ │ +2800 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 │ │ │ │ │ @@ -4515,17 +4506,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 1107 4 v 1289 100 a Fl(SolveMap)28 │ │ │ │ │ -b Fd(:)41 b Fk(DRAFT)121 b Fd(Ma)m(y)31 b(17,)h(2024)p │ │ │ │ │ -2746 100 V 1107 w Fm(3)111 399 y(2.)46 b Fl(int)h(SolveMap_nfront)d(\() │ │ │ │ │ +TeXDict begin 3 2 bop 91 100 1101 4 v 1282 100 a Fl(SolveMap)28 │ │ │ │ │ +b Fd(:)41 b Fk(DRAFT)121 b Fd(June)29 b(20,)j(2025)p │ │ │ │ │ +2753 100 V 1101 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 │ │ │ │ │ @@ -4581,17 +4572,17 @@ │ │ │ │ │ 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 1107 4 v │ │ │ │ │ -1289 w Fl(SolveMap)28 b Fd(:)41 b Fk(DRAFT)30 b Fd(Ma)m(y)i(17,)f(2024) │ │ │ │ │ -p 2793 100 V 66 399 a Fm(11.)46 b Fl(int)h(*)h(SolveMap_colidsLower)42 │ │ │ │ │ +TeXDict begin 4 3 bop 0 100 a Fm(4)p 136 100 1101 4 v │ │ │ │ │ +1282 w Fl(SolveMap)28 b Fd(:)41 b Fk(DRAFT)30 b Fd(June)g(20,)h(2025)p │ │ │ │ │ +2800 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 │ │ │ │ │ @@ -4649,17 +4640,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 1107 4 v 1289 100 a Fl(SolveMap)28 │ │ │ │ │ -b Fd(:)41 b Fk(DRAFT)121 b Fd(Ma)m(y)31 b(17,)h(2024)p │ │ │ │ │ -2746 100 V 1107 w Fm(5)0 399 y Fb(1.2.5)112 b(Solv)m(e)38 │ │ │ │ │ +TeXDict begin 5 4 bop 91 100 1101 4 v 1282 100 a Fl(SolveMap)28 │ │ │ │ │ +b Fd(:)41 b Fk(DRAFT)121 b Fd(June)29 b(20,)j(2025)p │ │ │ │ │ +2753 100 V 1101 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 │ │ │ │ │ @@ -4727,37 +4718,37 @@ │ │ │ │ │ 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 1107 4 v │ │ │ │ │ -1289 w Fl(SolveMap)28 b Fd(:)41 b Fk(DRAFT)30 b Fd(Ma)m(y)i(17,)f(2024) │ │ │ │ │ -p 2793 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 │ │ │ │ │ -b(b)m(y)e Fl(rowidsLower[*])p Fm(,)0 1597 y Fl(colidsLower[*])26 │ │ │ │ │ +TeXDict begin 6 5 bop 0 100 a Fm(6)p 136 100 1101 4 v │ │ │ │ │ +1282 w Fl(SolveMap)28 b Fd(:)41 b Fk(DRAFT)30 b Fd(June)g(20,)h(2025)p │ │ │ │ │ +2800 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 b(b)m(y)e │ │ │ │ │ +Fl(rowidsLower[*])p Fm(,)0 1597 y Fl(colidsLower[*])26 │ │ │ │ │ b Fm(and)k Fl(mapidsLower[*])p Fm(.)111 1844 y(1.)46 │ │ │ │ │ b Fl(int)h(SolveMap_readFromFile)42 b(\()48 b(SolveMap)d(*solvemap,)g │ │ │ │ │ (char)i(*fn)g(\))g(;)227 1998 y Fm(This)29 b(metho)s(d)g(reads)g(an)g │ │ │ │ │ Fl(SolveMap)e Fm(ob)5 b(ject)30 b(from)f(a)h(\014le.)41 │ │ │ │ │ b(If)29 b(the)g(the)h(\014le)f(can)h(b)s(e)f(op)s(ened)f(successfully) │ │ │ │ │ -8 b(,)227 2110 y(the)21 b(metho)s(d)e(calls)j Fl(SolveMap)p │ │ │ │ │ 1277 2110 V 32 w(readFromFormattedFile\(\))14 b Fm(or)20 │ │ │ │ │ @@ -4816,17 +4807,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 1107 4 v 1289 100 a Fl(SolveMap)28 │ │ │ │ │ -b Fd(:)41 b Fk(DRAFT)121 b Fd(Ma)m(y)31 b(17,)h(2024)p │ │ │ │ │ -2746 100 V 1107 w Fm(7)111 399 y(6.)46 b Fl(int)h │ │ │ │ │ +TeXDict begin 7 6 bop 91 100 1101 4 v 1282 100 a Fl(SolveMap)28 │ │ │ │ │ +b Fd(:)41 b Fk(DRAFT)121 b Fd(June)29 b(20,)j(2025)p │ │ │ │ │ +2753 100 V 1101 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 May 17, 2024 │ │ │ │ │ │ + 2 SolveMap : DRAFT June 20, 2025 │ │ │ │ │ │ • 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 May 17, 2024 3 │ │ │ │ │ │ + SolveMap : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 4 SolveMap : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 5 │ │ │ │ │ │ + SolveMap : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 6 SolveMap : DRAFT June 20, 2025 │ │ │ │ │ │ (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 May 17, 2024 7 │ │ │ │ │ │ + SolveMap : DRAFT June 20, 2025 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 2024.05.17:2218 │ │ │ │ │ +%DVIPSSource: TeX output 2025.06.20:0450 │ │ │ │ │ %%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 │ │ │ │ │ @@ -2118,22 +2118,21 @@ │ │ │ │ │ /UnderlinePosition -100 def │ │ │ │ │ /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 49 /one put │ │ │ │ │ dup 50 /two put │ │ │ │ │ -dup 52 /four put │ │ │ │ │ -dup 55 /seven put │ │ │ │ │ +dup 53 /five put │ │ │ │ │ dup 58 /colon put │ │ │ │ │ -dup 77 /M put │ │ │ │ │ -dup 97 /a put │ │ │ │ │ -dup 121 /y put │ │ │ │ │ +dup 74 /J put │ │ │ │ │ +dup 101 /e put │ │ │ │ │ +dup 110 /n put │ │ │ │ │ +dup 117 /u put │ │ │ │ │ readonly def │ │ │ │ │ currentdict end │ │ │ │ │ currentfile eexec │ │ │ │ │ D9D66F633B846AB284BCF8B0411B772DE5CE32340DC6F28AF40857E4451976E7 │ │ │ │ │ 5182433CF9F333A38BD841C0D4E68BF9E012EB32A8FFB76B5816306B5EDF7C99 │ │ │ │ │ 8B3A16D9B4BC056662E32C7CD0123DFAEB734C7532E64BBFBF5A60336E646716 │ │ │ │ │ EFB852C877F440D329172C71F1E5D59CE9473C26B8AEF7AD68EF0727B6EC2E0C │ │ │ │ │ @@ -2314,72 +2313,64 @@ │ │ │ │ │ 7CA1534C4D5B05FC33F83790ECFD7641DF3FB94289E2A1F6E7D29AB1228A867A │ │ │ │ │ 6E1EF0E9C6F899B491DC18401C2C0A05FFFED46A72C245F7529B8EA55A038082 │ │ │ │ │ 8512307217D2A233C37004085BA3AEE379269F9FA7D0ADB4B19A95CC2AFE686E │ │ │ │ │ 55D88E47257C1FE6F235FEA295910569FE6DD5995512562359CC821E85A6C7A5 │ │ │ │ │ 79B470A9E340A6985189FF8B6AF914A6B0ECF93F47903221F95DE894A8F05B05 │ │ │ │ │ B7D99CD533EC5F931B18E6B39BECF67FA2D6DD1AEC76772B068BE06335A94C05 │ │ │ │ │ 7A4DDEE77B66101DA855C17AC312600370B34E31F5EC3A01300A8EB60B4C9767 │ │ │ │ │ -1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004B9BA1CC │ │ │ │ │ -580D3C6BDA4DC1B80B4365F1C80512453FC5316EC2D928FB731C3D6403E3C18B │ │ │ │ │ -E8424D644DF5E9A2134229C5C91CA68DB8E85BA2BB40F538F585DA6FA4037718 │ │ │ │ │ -B8053EBBA1E765346BCD5BDAA6C38115D31611D8A87A2238C145F2DA2F92E4DF │ │ │ │ │ -3987BD9C4D2A3D460E8941A68B125BCD9EE4F9FD262C4C8A71F47A2C81975635 │ │ │ │ │ -F1B981C274C53FA2ACCDE4C9D0A7C62D6C1EFF91CFC6712CA6A9F333C9564FCB │ │ │ │ │ -2A70F0AD715A79B10A08AB069E2A3C93BC0AED19D0CA10134B8DDDE8AF548DB2 │ │ │ │ │ -3A4AAA9C29682CF135BB767DAA16169A127EB50A7EECEB6480CF56A7D0F8AC56 │ │ │ │ │ -4A5090B3D75A790372886AF568D94C8165975A05BFBFDF1FFBA45F70700BB9E0 │ │ │ │ │ -57F3249EF9E9C8AD9CBCF6E4FD592DC4CDD2CC7C0BC3130C1059096C657BE453 │ │ │ │ │ -A2CBACE93420210E27AF56CA229BD6D982FB68B3FDC6D44478B922C4231C47EE │ │ │ │ │ -E500232F6C11D92DEB955F66DF52B92B22E7352790CC2DCBAC53965D57AC2920 │ │ │ │ │ -68B7D520DE25047146EFEB06B9AD4E2A94243C7E5239F0BC2FC312B16051D52C │ │ │ │ │ -0B92C217B6B42997321AE4F8BB066754B7AA3F15069EF59224E8A442CE471AA7 │ │ │ │ │ -E8049A3DD9EDA09CCEE4998998661CF7DB35E952F6C65DAEB3013951C59F3E09 │ │ │ │ │ -157F313B0237876E1C0190F0473819570B8C0205AADF05D787CC00979CFB327A │ │ │ │ │ -289382B22DDA6F12804ED0ED5B179E36A995A2A59E1B66E75130DBE9109C813B │ │ │ │ │ -94403E0DEA8314A1E9DB474D7FA83C0BAFD08033E6A6215844C1D26BE15F1251 │ │ │ │ │ -A1605E8DF9A9C601ED37379530BC1C82BE5463C6C711C5652BFD6262485AA9CA │ │ │ │ │ -B8C4A117593001D08D980041E2A83C190DCE8E6CD3D334E5CC19FC05DB30F7F7 │ │ │ │ │ -24A305C4DBB31F0651392B99D44B4302333BDF7E326FD256DD75D309C6E73F85 │ │ │ │ │ -FA71B35FD1F9BEFF4C7A1076362EEB0A85492933B6006086A7B8C1928CF2D1EE │ │ │ │ │ -FD4344409257BB802C117E739960821CD3C88BFBA5669FF16F610AD638AF3677 │ │ │ │ │ -8674C985E6767253ED5769F71BEA5E9BB02A751F9E62EE2B18AC19D975FDEAE9 │ │ │ │ │ -8B8822367FF177A7E850766DE99ED3366D46464612926430012212A90F8E85F4 │ │ │ │ │ -4760B40D5B86B90819EE410382C23E86DCAF4F0FF5DFEB2C285965F4DCF2FB2B │ │ │ │ │ -457C0A0427A8D4ADA514E9DACD0F9367E1DA225DB21DA4DDAE33F2B529686D92 │ │ │ │ │ -AC085B345565F9DFFA012FD494DBB2E0B44A0787B2B72DC8D25399DAAE8864B7 │ │ │ │ │ -E84AA99DAFCEAF18F8B41882720316450F1B1CA48B418C9736E5CE4AFF996111 │ │ │ │ │ -5F7FE80958B6A3498508E9693CB134402D92E30D4C2939070D4647E13682290E │ │ │ │ │ -1D0820A3FCA7147157D09D1A40771F214EAE7DD743EA26839E535CA186C05CB8 │ │ │ │ │ -4874988AA1104D85AF0220FE7224344FF624E794BD2454E1C0AC971522FBECBA │ │ │ │ │ -B2497F25CD621B77EC5160973EF5ECC39C183DC051B0DFCB090194A2525BD96E │ │ │ │ │ -28593FDA80D8D259F039416D5F9AF0AD3C9A105B49DAF6E681921E369B7666C6 │ │ │ │ │ -2B73DB37447B00AE96317C2F1C44FB6E6EFD740BAB20FA03A8CE018EC8415582 │ │ │ │ │ -FB06E88A2971E3A480FB1EB4FE93CC7E5179721CAABEE88742B13CF0405F49F4 │ │ │ │ │ -945E587668C821D8C06D6847B6DF84CAFFCD4628670D551FC5F7236875BE1207 │ │ │ │ │ -634BA7F70A19B658FAE7D86F6D00ED28FBF29CC585DEE279325EEF8B0CCB6149 │ │ │ │ │ -E46E638C73D75148F18A636DBC2DD96ED34F68A5A09A3700B1EA34B2D142807C │ │ │ │ │ -F8709D81180783548EAE6F457BF968602076A1069163E3C15BBCEF659C6CF2E6 │ │ │ │ │ -0BB01BDC8E503802CC7969A5B8477E9788C5249B23B19669F5075E089738E49A │ │ │ │ │ -8671D7C1B1B47652F3D78BF2FF74EDB44BA5B092E8D5B85001E97F69D54AEEFC │ │ │ │ │ -88FC3CA1B0D5BAC39263B371005BCFA19AD197A31CC34D0BD55C2CA18C60C485 │ │ │ │ │ -5993F736EF1DD2C5D2B4D50B3D498861B4DF5E7AFF614BBCA4C2E6BECC0DCEF5 │ │ │ │ │ -95F0D686188014C530D8E37650CDCAE721B4AFB0F178BC744BDDDED45DAB7FEB │ │ │ │ │ -A10B975E26099E3DC61116D6BF554574F948895B88EEFE03DCC5351190836AD4 │ │ │ │ │ -EBC1AC55C6D099A8E7B0A372D290C481F44FA464B9C11A0BC991CB045E0AAAC4 │ │ │ │ │ -5C73CA43A4F17D1ADDD33D1B917FF95BFF411C8409F41553B1BC97DE47E3A1F4 │ │ │ │ │ -A5C1D1B7B1BF7E2507AC53956C141411F4F657E37981996DD7BB7ADB2CB6AE01 │ │ │ │ │ -73D0876B8F896F626D5022FE53BA34D5668BD698BE8D5CCAD083CBCEF440BE6A │ │ │ │ │ -8090EB1CDEE5F99C8988650BD4E539B357C31C597D8A9104A9D5967D4E906CAD │ │ │ │ │ -2A65575A884B1C5F6CC509E742FA9DDD66494F219178161AF72C50848E226A95 │ │ │ │ │ -A8C247FF9FF0BABD073021271B5C0692F9BE220071DAB09E5A026629371EE3C4 │ │ │ │ │ -A6E4FA94625D87A5B66EF077ED54C72B1052AEAA9637B30C76EF8EB04AD5F476 │ │ │ │ │ -D15F1C93C0BC6E0F67B366097BBED03FE82C040F9EF02866159B46854E11D44F │ │ │ │ │ -54AE6748A7E61B993A4EECD3B8BE3B5897A66BBCDFE24F65BC2AD5AB49048CF1 │ │ │ │ │ -647203823F84DF5CB483096F9D96AEE3A2855E479B72A14A67C633CE99C101CF │ │ │ │ │ -EFAE939BF9B02E710D │ │ │ │ │ +1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004ACD1870 │ │ │ │ │ +A5EA947858F5795870BFE1343AD803FB854BF8F5A4E794E8EC57BE41DB5B8734 │ │ │ │ │ +13E47950F29A81EA0C81EA798863883D7F41F78325CA190CBBFFE822AE494550 │ │ │ │ │ +4BE83703071FC9512D128927AF3F63CEF8F86ABE1E15D7B4DDD39576E7DFF45E │ │ │ │ │ +3CB4115AAB1830DE8647B915DB4BEBEB5235C281E098B899BAB951D8D5798F01 │ │ │ │ │ +7F7C47336D31438E5126738AFEAB29E9A7CBE06DE4DD604477B542D2620DFD58 │ │ │ │ │ +28FE34238572F23C5A8EB7ACEE1E154DA13FC1A5AA67A3BA8C5CDFB2B80312C9 │ │ │ │ │ +BC9FAE56D08DDFA9498E6EF0D0F6BD18B3923E0B670B0740528BC843610736CB │ │ │ │ │ +80228C105C2F72C3C22D610C3D8C268DEEA2AEEE3221E198E79FE2966487360C │ │ │ │ │ +84AE08AC326F48B21447652121B1EB68AF856055EEA65B6B625BF622CBFC2D1C │ │ │ │ │ +EF943CC4CAF2C715782C9EF9A9BA4689BFC6B6A82F8D55795BE8111E2C7DE520 │ │ │ │ │ +367362304B6A48186C842033E715A46265A352472F4F7313248EBCD26BEA97E7 │ │ │ │ │ +B814A61D4B7ADCB5C5F21AA34E0C1269E8426DBFB511DE6E26B960456C8F8520 │ │ │ │ │ +5F0DD382289A62AF0B935EDB5B2394538C5F0EE72962D2F98F3C38CD7C027B9F │ │ │ │ │ +E230E67E40FEFBDED06B3423C9DFD669E6B5BC913E0FF75786A64A6C11D4FE89 │ │ │ │ │ +1B918DC0E953C52CFD153063CD0D2A78B43F8712243845E6F2CBA1DB610F403D │ │ │ │ │ +A98D06D95FF44C7AC029092B666A8B0DCEA95B34F5ACC10E8611BADE6A24469C │ │ │ │ │ +0C01D95BFB445FA22CD38D033E4D24E006BB9D54EE41EF7AD5AC9C299721F61A │ │ │ │ │ +F01B6EDCDF428BD9195A13C5B1027358F8A203F828A1DD9622243B2D76C6F1BA │ │ │ │ │ +9F2D7E9D4879FC668ABC750CD25415DC6CCF2257C28F78D3F9BE499CC0FF2F80 │ │ │ │ │ +2C2CD1DEFABD6668FCA76E1D629A344333E33DA24B86D2E9F8F5EE1C29974640 │ │ │ │ │ +C3E78E999BAB313400041DADDDFDBFFCC419F129A84F4D412B79E8BE4511CA00 │ │ │ │ │ +F92A4F3CDD2E51345D3965C104F06B6503445DC20224CB7606A9D7D5F9EE45E6 │ │ │ │ │ +1B2963DA96AA2AB1BA5BE29656E666E4D0E122DE58EEA68E04ED76438DA03E65 │ │ │ │ │ +B80055A86B7B2A26BAE6BBB8835E17F9696E9B3CD34571BA75C76D4D2CCC48F1 │ │ │ │ │ +7534C1EF9127E374D65D05B8072E08D6C72A0B4A35EA0DD717743C66D105CCD8 │ │ │ │ │ +7355F13E9C38C1A4351624E689ED7909100942FA0474842EE44DEC3279E1A1CD │ │ │ │ │ +8064666EB845CA7C3E906B67C0BF96A28D514DB2E4A1E4AF287350B03762A2CF │ │ │ │ │ +13B18AC3F5D2F3B74A1D50267C03EFB74B888E1D24ABEEA4A885F4D0BF14C0D8 │ │ │ │ │ +289AC79D6D98E2A2C831672FB1F3457564CD161ADC3AF610D88201AB5B0C10CB │ │ │ │ │ +5ECCC2D5C4AF39C8CB3044BF9EC791BA45D29C2B51EA0483D19822C264CE6FA3 │ │ │ │ │ +5C97F2DF5A78CB93528E99B9ED7CB121C83130C129B849B52A36EBD88AF19DD3 │ │ │ │ │ +C5CABE831027388EF86BD5CBD90AAAC089775938A321C44D4DDA67A51312D8AB │ │ │ │ │ +C509DDBE7044A107AB2BE9C4C9556F85C529B174A7778B489BF28EC07A834542 │ │ │ │ │ +8B31F2925C21FB2096877711F998763D5A8495002B8E080AF8DBB1B3106EDDBA │ │ │ │ │ +35121D52E0846A7AF3ABEDF87BDE4FA665673A9B80CA538B98F873947AA17EF4 │ │ │ │ │ +9BB182917E9D79BC7EC681E93710D6A1D6B0E4A7FA9452FC1C431808174F3AB7 │ │ │ │ │ +F3914FBC86CB34E8583457243C3C7BE4BC166C7397689BC6FFB82EA2967E88EE │ │ │ │ │ +464F96EDA144DE2B64401B8E577ABCA2D826FE0B92E21FFAE3E81EBB6B6EB36E │ │ │ │ │ +9B1A8FE3884CA398C03135FD49D51724FC1268E9482E41FAEA2FC6C809006B8F │ │ │ │ │ +5D4F9E038450AD3A6041C16FD1C7E5FC80C0E033CE57E64863E014531D94DF1E │ │ │ │ │ +31D7D038AFCB60715AA73C1E96F113A24C5AF35BBEB61C4D079ED034ED83AA4A │ │ │ │ │ +E12448E618330463304788BCF40561CD63167B3BF144F408E2B89E60B8BA13EF │ │ │ │ │ +3B57D286FD23D4FA8BAEFF98DC1188B1982956CC1DCAEFC7D949B7B4E3BE8F8A │ │ │ │ │ +BFE2C9D938DD13EFEE7123576608D9396F260907DA98AE2D3DD5822306CBC8A6 │ │ │ │ │ +B083C697DDA3C62EE7879436A9FD8EE0034B105105B3F122F893EA2126EBE8A9 │ │ │ │ │ +5CBF2BD248DD9FBEF0040C25797BD13B69A8C9F0D4E4F935C61ED30487CCDB1A │ │ │ │ │ +0339006E78EE1755929D2412776EC7DB1F666DBDD28EA8AC7397F809C7F38A41 │ │ │ │ │ +5B3BF6C75F4F35C90141EB08377AF452CF840FEA938805F9D14E02DC29215B4E │ │ │ │ │ +F1EB │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ @@ -5224,17 +5215,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 23[45 19[83 18[25 │ │ │ │ │ -2[45 2[45 1[45 45 45 3[25 44[{}10 90.9091 /CMSL10 rf │ │ │ │ │ -/Fh 132[52 123[{}1 90.9091 /CMBX10 rf │ │ │ │ │ +58[{}23 90.9091 /CMTI10 rf /Fg 138[51 6[51 8[40 26[47 │ │ │ │ │ +15[25 4[45 2[45 1[45 3[25 44[{}9 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 │ │ │ │ │ @@ -5358,17 +5349,17 @@ │ │ │ │ │ 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 1155 4 v │ │ │ │ │ -1337 w Fn(SubMtx)29 b Fg(:)40 b Ff(DRAFT)31 b Fg(Ma)m(y)g(17,)h(2024)p │ │ │ │ │ -2745 100 V 330 399 a Fh({)45 b Fo(a)31 b(diagonal)h(matrix)330 │ │ │ │ │ +TeXDict begin 2 1 bop 0 100 a Fo(2)p 136 100 1148 4 v │ │ │ │ │ +1330 w Fn(SubMtx)29 b Fg(:)40 b Ff(DRAFT)31 b Fg(June)e(20,)i(2025)p │ │ │ │ │ +2752 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 │ │ │ │ │ @@ -5439,17 +5430,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 1155 4 v 1337 100 a Fn(SubMtx)28 │ │ │ │ │ -b Fg(:)41 b Ff(DRAFT)121 b Fg(Ma)m(y)32 b(17,)f(2024)p │ │ │ │ │ -2698 100 V 1155 w Fo(3)330 399 y Fh({)45 b Fn(SPOOLES)p │ │ │ │ │ +TeXDict begin 3 2 bop 91 100 1148 4 v 1330 100 a Fn(SubMtx)28 │ │ │ │ │ +b Fg(:)41 b Ff(DRAFT)121 b Fg(June)29 b(20,)j(2025)p │ │ │ │ │ +2705 100 V 1148 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 │ │ │ │ │ @@ -5511,17 +5502,17 @@ │ │ │ │ │ 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 1155 4 v │ │ │ │ │ -1337 w Fn(SubMtx)29 b Fg(:)40 b Ff(DRAFT)31 b Fg(Ma)m(y)g(17,)h(2024)p │ │ │ │ │ -2745 100 V 137 399 a Fi(\210)45 b Fn(SUBMTX)p 521 399 │ │ │ │ │ +TeXDict begin 4 3 bop 0 100 a Fo(4)p 136 100 1148 4 v │ │ │ │ │ +1330 w Fn(SubMtx)29 b Fg(:)40 b Ff(DRAFT)31 b Fg(June)e(20,)i(2025)p │ │ │ │ │ +2752 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 │ │ │ │ │ @@ -5585,17 +5576,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 1155 4 v 1337 100 a Fn(SubMtx)28 │ │ │ │ │ -b Fg(:)41 b Ff(DRAFT)121 b Fg(Ma)m(y)32 b(17,)f(2024)p │ │ │ │ │ -2698 100 V 1155 w Fo(5)0 399 y Fc(1.2.2)112 b(Instance)38 │ │ │ │ │ +TeXDict begin 5 4 bop 91 100 1148 4 v 1330 100 a Fn(SubMtx)28 │ │ │ │ │ +b Fg(:)41 b Ff(DRAFT)121 b Fg(June)29 b(20,)j(2025)p │ │ │ │ │ +2705 100 V 1148 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 │ │ │ │ │ @@ -5663,17 +5654,17 @@ │ │ │ │ │ (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 1155 4 v │ │ │ │ │ -1337 w Fn(SubMtx)29 b Fg(:)40 b Ff(DRAFT)31 b Fg(Ma)m(y)g(17,)h(2024)p │ │ │ │ │ -2745 100 V 227 399 a Fn(*pentries)f Fo(with)i(the)g(base)g(address)f │ │ │ │ │ +TeXDict begin 6 5 bop 0 100 a Fo(6)p 136 100 1148 4 v │ │ │ │ │ +1330 w Fn(SubMtx)29 b Fg(:)40 b Ff(DRAFT)31 b Fg(June)e(20,)i(2025)p │ │ │ │ │ +2752 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 │ │ │ │ │ @@ -5759,17 +5750,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 1155 4 v 1337 100 a Fn(SubMtx)28 │ │ │ │ │ -b Fg(:)41 b Ff(DRAFT)121 b Fg(Ma)m(y)32 b(17,)f(2024)p │ │ │ │ │ -2698 100 V 1155 w Fo(7)227 399 y(column)38 b Fn(jcol)p │ │ │ │ │ +TeXDict begin 7 6 bop 91 100 1148 4 v 1330 100 a Fn(SubMtx)28 │ │ │ │ │ +b Fg(:)41 b Ff(DRAFT)121 b Fg(June)29 b(20,)j(2025)p │ │ │ │ │ +2705 100 V 1148 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 │ │ │ │ │ @@ -5844,17 +5835,17 @@ │ │ │ │ │ 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 1155 4 v │ │ │ │ │ -1337 w Fn(SubMtx)29 b Fg(:)40 b Ff(DRAFT)31 b Fg(Ma)m(y)g(17,)h(2024)p │ │ │ │ │ -2745 100 V 227 399 a Fo(If)h(the)g Fn(\(irow,jcol\))d │ │ │ │ │ +TeXDict begin 8 7 bop 0 100 a Fo(8)p 136 100 1148 4 v │ │ │ │ │ +1330 w Fn(SubMtx)29 b Fg(:)40 b Ff(DRAFT)31 b Fg(June)e(20,)i(2025)p │ │ │ │ │ +2752 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 │ │ │ │ │ @@ -5927,17 +5918,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 1155 4 v 1337 100 a Fn(SubMtx)28 │ │ │ │ │ -b Fg(:)41 b Ff(DRAFT)121 b Fg(Ma)m(y)32 b(17,)f(2024)p │ │ │ │ │ -2698 100 V 1155 w Fo(9)111 399 y(4.)46 b Fn(void)h │ │ │ │ │ +TeXDict begin 9 8 bop 91 100 1148 4 v 1330 100 a Fn(SubMtx)28 │ │ │ │ │ +b Fg(:)41 b Ff(DRAFT)121 b Fg(June)29 b(20,)j(2025)p │ │ │ │ │ +2705 100 V 1148 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 │ │ │ │ │ @@ -6019,51 +6010,51 @@ │ │ │ │ │ (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 1132 4 │ │ │ │ │ -v 1315 w Fn(SubMtx)28 b Fg(:)41 b Ff(DRAFT)30 b Fg(Ma)m(y)i(17,)f(2024) │ │ │ │ │ -p 2768 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 │ │ │ │ │ -(dense)e(subro)m(ws)f(or)i(sparse)f(ro)m(ws.)39 b(If)27 │ │ │ │ │ -b Fm(A)h Fo(is)g(strict)g(upp)s(er)d(triangular,)k(then)e │ │ │ │ │ -Fn(mtxA)227 886 y Fo(m)m(ust)k(ha)m(v)m(e)g(dense)f(sub)s(columns)f(or) │ │ │ │ │ -h(sparse)g(columns.)227 1035 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.)111 1219 y(3.)46 b Fn(void)h(SubMtx_solveT)d │ │ │ │ │ -(\()k(SubMtx)e(*mtxA,)g(SubMtx)g(*mtxB)g(\))i(;)227 1368 │ │ │ │ │ -y Fo(This)24 b(metho)s(d)h(is)f(used)h(to)g(solv)m(e)h(\()p │ │ │ │ │ -Fm(I)17 b Fo(+)9 b Fm(A)1605 1335 y Fl(T)1660 1368 y │ │ │ │ │ -Fo(\))p Fm(X)33 b Fo(=)25 b Fm(B)5 b Fo(,)26 b(where)e │ │ │ │ │ -Fm(A)h Fo(is)g(strict)g(lo)m(w)m(er)i(or)d(upp)s(er)f(triangular.)39 │ │ │ │ │ -b(The)227 1481 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 1593 y(then)27 b Fn(mtxA)g Fo(m)m(ust)g(ha)m(v)m(e)i │ │ │ │ │ -(dense)e(subro)m(ws)f(or)i(sparse)f(ro)m(ws.)39 b(If)27 │ │ │ │ │ -b Fm(A)h Fo(is)g(strict)g(upp)s(er)d(triangular,)k(then)e │ │ │ │ │ -Fn(mtxA)227 1706 y Fo(m)m(ust)k(ha)m(v)m(e)g(dense)f(sub)s(columns)f │ │ │ │ │ -(or)h(sparse)g(columns.)227 1855 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.)111 2040 y(4.)46 b Fn(void)h(SubMtx_solveupd)d │ │ │ │ │ -(\()j(SubMtx)f(*mtxY,)g(SubMtx)g(*mtxA,)g(SubMtx)g(*mtxX)h(\))g(;)227 │ │ │ │ │ -2188 y Fo(This)25 b(metho)s(d)g(is)h(used)f(to)i(up)s(date)e │ │ │ │ │ +TeXDict begin 10 9 bop 0 100 a Fo(10)p 182 100 1126 4 │ │ │ │ │ +v 1308 w Fn(SubMtx)28 b Fg(:)41 b Ff(DRAFT)30 b Fg(June)g(20,)h(2025)p │ │ │ │ │ +2775 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(dense)e(subro)m(ws) │ │ │ │ │ +f(or)i(sparse)f(ro)m(ws.)39 b(If)27 b Fm(A)h Fo(is)g(strict)g(upp)s(er) │ │ │ │ │ +d(triangular,)k(then)e Fn(mtxA)227 886 y Fo(m)m(ust)k(ha)m(v)m(e)g │ │ │ │ │ +(dense)f(sub)s(columns)f(or)h(sparse)g(columns.)227 1035 │ │ │ │ │ +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.)111 │ │ │ │ │ +1219 y(3.)46 b Fn(void)h(SubMtx_solveT)d(\()k(SubMtx)e(*mtxA,)g(SubMtx) │ │ │ │ │ +g(*mtxB)g(\))i(;)227 1368 y Fo(This)24 b(metho)s(d)h(is)f(used)h(to)g │ │ │ │ │ +(solv)m(e)h(\()p Fm(I)17 b Fo(+)9 b Fm(A)1605 1335 y │ │ │ │ │ +Fl(T)1660 1368 y Fo(\))p Fm(X)33 b Fo(=)25 b Fm(B)5 b │ │ │ │ │ +Fo(,)26 b(where)e Fm(A)h Fo(is)g(strict)g(lo)m(w)m(er)i(or)d(upp)s(er)f │ │ │ │ │ +(triangular.)39 b(The)227 1481 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 │ │ │ │ │ +1593 y(then)27 b Fn(mtxA)g Fo(m)m(ust)g(ha)m(v)m(e)i(dense)e(subro)m │ │ │ │ │ +(ws)f(or)i(sparse)f(ro)m(ws.)39 b(If)27 b Fm(A)h Fo(is)g(strict)g(upp)s │ │ │ │ │ +(er)d(triangular,)k(then)e Fn(mtxA)227 1706 y Fo(m)m(ust)k(ha)m(v)m(e)g │ │ │ │ │ +(dense)f(sub)s(columns)f(or)h(sparse)g(columns.)227 1855 │ │ │ │ │ +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.)111 │ │ │ │ │ +2040 y(4.)46 b Fn(void)h(SubMtx_solveupd)d(\()j(SubMtx)f(*mtxY,)g │ │ │ │ │ +(SubMtx)g(*mtxA,)g(SubMtx)g(*mtxX)h(\))g(;)227 2188 y │ │ │ │ │ +Fo(This)25 b(metho)s(d)g(is)h(used)f(to)i(up)s(date)e │ │ │ │ │ Fm(Y)45 b Fo(:=)25 b Fm(Y)31 b Fj(\000)11 b Fm(A)g Fj(\003)g │ │ │ │ │ Fm(X)c Fo(,)28 b(where)d Fm(A)h Fo(has)g(dense)f(or)h(sparse)f(ro)m(ws) │ │ │ │ │ h(or)g(columns.)227 2301 y Fn(mtxY)j Fo(and)h Fn(mtxX)f │ │ │ │ │ Fo(m)m(ust)i(ha)m(v)m(e)g(dense)f(columns.)227 2450 y │ │ │ │ │ Ff(Err)-5 b(or)35 b(che)-5 b(cking:)43 b Fo(If)31 b Fn(mtxY)p │ │ │ │ │ Fo(,)g Fn(mtxA)f Fo(or)i Fn(mtxX)f Fo(is)g Fn(NULL)p │ │ │ │ │ Fo(,)g(an)g(error)h(message)g(is)g(prin)m(ted)f(and)g(the)h(program)227 │ │ │ │ │ @@ -6102,17 +6093,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 1132 4 v 1314 100 a Fn(SubMtx)28 │ │ │ │ │ -b Fg(:)41 b Ff(DRAFT)121 b Fg(Ma)m(y)32 b(17,)f(2024)p │ │ │ │ │ -2675 100 V 1132 w Fo(11)227 399 y Ff(Err)-5 b(or)34 b(che)-5 │ │ │ │ │ +TeXDict begin 11 10 bop 91 100 1126 4 v 1307 100 a Fn(SubMtx)29 │ │ │ │ │ +b Fg(:)40 b Ff(DRAFT)121 b Fg(June)30 b(20,)h(2025)p │ │ │ │ │ +2682 100 V 1126 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 │ │ │ │ │ @@ -6170,18 +6161,18 @@ │ │ │ │ │ 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 1132 │ │ │ │ │ -4 v 1315 w Fn(SubMtx)28 b Fg(:)41 b Ff(DRAFT)30 b Fg(Ma)m(y)i(17,)f │ │ │ │ │ -(2024)p 2768 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 │ │ │ │ │ +TeXDict begin 12 11 bop 0 100 a Fo(12)p 182 100 1126 │ │ │ │ │ +4 v 1308 w Fn(SubMtx)28 b Fg(:)41 b Ff(DRAFT)30 b Fg(June)g(20,)h(2025) │ │ │ │ │ +p 2775 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) │ │ │ │ │ @@ -6244,17 +6235,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 1132 4 v 1314 100 a Fn(SubMtx)28 │ │ │ │ │ -b Fg(:)41 b Ff(DRAFT)121 b Fg(Ma)m(y)32 b(17,)f(2024)p │ │ │ │ │ -2675 100 V 1132 w Fo(13)227 399 y(Note,)40 b(if)c(the)g(m)m(txutation)i │ │ │ │ │ +TeXDict begin 13 12 bop 91 100 1126 4 v 1307 100 a Fn(SubMtx)29 │ │ │ │ │ +b Fg(:)40 b Ff(DRAFT)121 b Fg(June)30 b(20,)h(2025)p │ │ │ │ │ +2682 100 V 1126 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 │ │ │ │ │ @@ -6323,32 +6314,32 @@ │ │ │ │ │ (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 1132 │ │ │ │ │ -4 v 1315 w Fn(SubMtx)28 b Fg(:)41 b Ff(DRAFT)30 b Fg(Ma)m(y)i(17,)f │ │ │ │ │ -(2024)p 2768 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) │ │ │ │ │ -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 1489 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 │ │ │ │ │ -1602 y(data.)337 1750 y Fi(\210)45 b Fo(The)35 b Fn(inFile)e │ │ │ │ │ +TeXDict begin 14 13 bop 0 100 a Fo(14)p 182 100 1126 │ │ │ │ │ +4 v 1308 w Fn(SubMtx)28 b Fg(:)41 b Ff(DRAFT)30 b Fg(June)g(20,)h(2025) │ │ │ │ │ +p 2775 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)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 │ │ │ │ │ +1489 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 1602 │ │ │ │ │ +y(data.)337 1750 y Fi(\210)45 b Fo(The)35 b Fn(inFile)e │ │ │ │ │ Fo(parameter)i(is)g(the)h(input)e(\014le)h(for)f(the)h │ │ │ │ │ Fn(SubMtx)f Fo(ob)5 b(ject.)55 b(It)35 b(m)m(ust)g(b)s(e)f(of)h(the)g │ │ │ │ │ (form)427 1863 y Fn(*.submtxf)18 b Fo(or)i Fn(*.submtxb)p │ │ │ │ │ Fo(.)35 b(The)20 b Fn(SubMtx)e Fo(ob)5 b(ject)22 b(is)e(read)g(from)g │ │ │ │ │ (the)g(\014le)h(via)g(the)f Fn(SubMtx)p 3559 1863 29 │ │ │ │ │ 4 v 33 w(readFromFile\(\))427 1976 y Fo(metho)s(d.)337 │ │ │ │ │ 2125 y Fi(\210)45 b Fo(The)29 b Fn(outFile)e Fo(parameter)i(is)g(the)h │ │ │ │ │ @@ -6400,17 +6391,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 1132 4 v 1314 100 a Fn(SubMtx)28 │ │ │ │ │ -b Fg(:)41 b Ff(DRAFT)121 b Fg(Ma)m(y)32 b(17,)f(2024)p │ │ │ │ │ -2675 100 V 1132 w Fo(15)337 399 y Fi(\210)45 b Fo(The)33 │ │ │ │ │ +TeXDict begin 15 14 bop 91 100 1126 4 v 1307 100 a Fn(SubMtx)29 │ │ │ │ │ +b Fg(:)40 b Ff(DRAFT)121 b Fg(June)30 b(20,)h(2025)p │ │ │ │ │ +2682 100 V 1126 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 │ │ │ │ │ @@ -6490,19 +6481,19 @@ │ │ │ │ │ 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 1132 │ │ │ │ │ -4 v 1315 w Fn(SubMtx)28 b Fg(:)41 b Ff(DRAFT)30 b Fg(Ma)m(y)i(17,)f │ │ │ │ │ -(2024)p 2768 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 │ │ │ │ │ +TeXDict begin 16 15 bop 0 100 a Fo(16)p 182 100 1126 │ │ │ │ │ +4 v 1308 w Fn(SubMtx)28 b Fg(:)41 b Ff(DRAFT)30 b Fg(June)g(20,)h(2025) │ │ │ │ │ +p 2775 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 │ │ │ │ │ @@ -6582,17 +6573,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 1132 4 v 1314 100 a Fn(SubMtx)28 │ │ │ │ │ -b Fg(:)41 b Ff(DRAFT)121 b Fg(Ma)m(y)32 b(17,)f(2024)p │ │ │ │ │ -2675 100 V 1132 w Fo(17)337 399 y Fi(\210)45 b Fo(The)f │ │ │ │ │ +TeXDict begin 17 16 bop 91 100 1126 4 v 1307 100 a Fn(SubMtx)29 │ │ │ │ │ +b Fg(:)40 b Ff(DRAFT)121 b Fg(June)30 b(20,)h(2025)p │ │ │ │ │ +2682 100 V 1126 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 │ │ │ │ │ @@ -6671,21 +6662,21 @@ │ │ │ │ │ (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 1132 │ │ │ │ │ -4 v 1315 w Fn(SubMtx)28 b Fg(:)41 b Ff(DRAFT)30 b Fg(Ma)m(y)i(17,)f │ │ │ │ │ -(2024)p 2768 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 │ │ │ │ │ +TeXDict begin 18 17 bop 0 100 a Fo(18)p 182 100 1126 │ │ │ │ │ +4 v 1308 w Fn(SubMtx)28 b Fg(:)41 b Ff(DRAFT)30 b Fg(June)g(20,)h(2025) │ │ │ │ │ +p 2775 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 │ │ │ │ │ Fo(for)g(just)427 1100 y(timing)31 b(output.)337 1246 │ │ │ │ │ ├── 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 May 17, 2024 │ │ │ │ │ │ + 2 SubMtx : DRAFT June 20, 2025 │ │ │ │ │ │ – 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 May 17, 2024 3 │ │ │ │ │ │ + SubMtx : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 4 SubMtx : DRAFT June 20, 2025 │ │ │ │ │ │ • 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 May 17, 2024 5 │ │ │ │ │ │ + SubMtx : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 6 SubMtx : DRAFT June 20, 2025 │ │ │ │ │ │ *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 May 17, 2024 7 │ │ │ │ │ │ + SubMtx : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 8 SubMtx : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 9 │ │ │ │ │ │ + SubMtx : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 10 SubMtx : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 11 │ │ │ │ │ │ + SubMtx : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 12 SubMtx : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 13 │ │ │ │ │ │ + SubMtx : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 14 SubMtx : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 15 │ │ │ │ │ │ + SubMtx : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 16 SubMtx : DRAFT June 20, 2025 │ │ │ │ │ │ • 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 May 17, 2024 17 │ │ │ │ │ │ + SubMtx : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 18 SubMtx : DRAFT June 20, 2025 │ │ │ │ │ │ 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 2024.05.17:2218 │ │ │ │ │ +%DVIPSSource: TeX output 2025.06.20:0450 │ │ │ │ │ %%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 │ │ │ │ │ @@ -1776,22 +1776,21 @@ │ │ │ │ │ /UnderlinePosition -100 def │ │ │ │ │ /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 49 /one put │ │ │ │ │ dup 50 /two put │ │ │ │ │ -dup 52 /four put │ │ │ │ │ -dup 55 /seven put │ │ │ │ │ +dup 53 /five put │ │ │ │ │ dup 58 /colon put │ │ │ │ │ -dup 77 /M put │ │ │ │ │ -dup 97 /a put │ │ │ │ │ -dup 121 /y put │ │ │ │ │ +dup 74 /J put │ │ │ │ │ +dup 101 /e put │ │ │ │ │ +dup 110 /n put │ │ │ │ │ +dup 117 /u put │ │ │ │ │ readonly def │ │ │ │ │ currentdict end │ │ │ │ │ currentfile eexec │ │ │ │ │ D9D66F633B846AB284BCF8B0411B772DE5CE32340DC6F28AF40857E4451976E7 │ │ │ │ │ 5182433CF9F333A38BD841C0D4E68BF9E012EB32A8FFB76B5816306B5EDF7C99 │ │ │ │ │ 8B3A16D9B4BC056662E32C7CD0123DFAEB734C7532E64BBFBF5A60336E646716 │ │ │ │ │ EFB852C877F440D329172C71F1E5D59CE9473C26B8AEF7AD68EF0727B6EC2E0C │ │ │ │ │ @@ -1972,72 +1971,64 @@ │ │ │ │ │ 7CA1534C4D5B05FC33F83790ECFD7641DF3FB94289E2A1F6E7D29AB1228A867A │ │ │ │ │ 6E1EF0E9C6F899B491DC18401C2C0A05FFFED46A72C245F7529B8EA55A038082 │ │ │ │ │ 8512307217D2A233C37004085BA3AEE379269F9FA7D0ADB4B19A95CC2AFE686E │ │ │ │ │ 55D88E47257C1FE6F235FEA295910569FE6DD5995512562359CC821E85A6C7A5 │ │ │ │ │ 79B470A9E340A6985189FF8B6AF914A6B0ECF93F47903221F95DE894A8F05B05 │ │ │ │ │ B7D99CD533EC5F931B18E6B39BECF67FA2D6DD1AEC76772B068BE06335A94C05 │ │ │ │ │ 7A4DDEE77B66101DA855C17AC312600370B34E31F5EC3A01300A8EB60B4C9767 │ │ │ │ │ -1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004B9BA1CC │ │ │ │ │ -580D3C6BDA4DC1B80B4365F1C80512453FC5316EC2D928FB731C3D6403E3C18B │ │ │ │ │ -E8424D644DF5E9A2134229C5C91CA68DB8E85BA2BB40F538F585DA6FA4037718 │ │ │ │ │ -B8053EBBA1E765346BCD5BDAA6C38115D31611D8A87A2238C145F2DA2F92E4DF │ │ │ │ │ -3987BD9C4D2A3D460E8941A68B125BCD9EE4F9FD262C4C8A71F47A2C81975635 │ │ │ │ │ -F1B981C274C53FA2ACCDE4C9D0A7C62D6C1EFF91CFC6712CA6A9F333C9564FCB │ │ │ │ │ -2A70F0AD715A79B10A08AB069E2A3C93BC0AED19D0CA10134B8DDDE8AF548DB2 │ │ │ │ │ -3A4AAA9C29682CF135BB767DAA16169A127EB50A7EECEB6480CF56A7D0F8AC56 │ │ │ │ │ -4A5090B3D75A790372886AF568D94C8165975A05BFBFDF1FFBA45F70700BB9E0 │ │ │ │ │ -57F3249EF9E9C8AD9CBCF6E4FD592DC4CDD2CC7C0BC3130C1059096C657BE453 │ │ │ │ │ -A2CBACE93420210E27AF56CA229BD6D982FB68B3FDC6D44478B922C4231C47EE │ │ │ │ │ -E500232F6C11D92DEB955F66DF52B92B22E7352790CC2DCBAC53965D57AC2920 │ │ │ │ │ -68B7D520DE25047146EFEB06B9AD4E2A94243C7E5239F0BC2FC312B16051D52C │ │ │ │ │ -0B92C217B6B42997321AE4F8BB066754B7AA3F15069EF59224E8A442CE471AA7 │ │ │ │ │ -E8049A3DD9EDA09CCEE4998998661CF7DB35E952F6C65DAEB3013951C59F3E09 │ │ │ │ │ -157F313B0237876E1C0190F0473819570B8C0205AADF05D787CC00979CFB327A │ │ │ │ │ -289382B22DDA6F12804ED0ED5B179E36A995A2A59E1B66E75130DBE9109C813B │ │ │ │ │ -94403E0DEA8314A1E9DB474D7FA83C0BAFD08033E6A6215844C1D26BE15F1251 │ │ │ │ │ -A1605E8DF9A9C601ED37379530BC1C82BE5463C6C711C5652BFD6262485AA9CA │ │ │ │ │ -B8C4A117593001D08D980041E2A83C190DCE8E6CD3D334E5CC19FC05DB30F7F7 │ │ │ │ │ -24A305C4DBB31F0651392B99D44B4302333BDF7E326FD256DD75D309C6E73F85 │ │ │ │ │ -FA71B35FD1F9BEFF4C7A1076362EEB0A85492933B6006086A7B8C1928CF2D1EE │ │ │ │ │ -FD4344409257BB802C117E739960821CD3C88BFBA5669FF16F610AD638AF3677 │ │ │ │ │ -8674C985E6767253ED5769F71BEA5E9BB02A751F9E62EE2B18AC19D975FDEAE9 │ │ │ │ │ -8B8822367FF177A7E850766DE99ED3366D46464612926430012212A90F8E85F4 │ │ │ │ │ -4760B40D5B86B90819EE410382C23E86DCAF4F0FF5DFEB2C285965F4DCF2FB2B │ │ │ │ │ -457C0A0427A8D4ADA514E9DACD0F9367E1DA225DB21DA4DDAE33F2B529686D92 │ │ │ │ │ -AC085B345565F9DFFA012FD494DBB2E0B44A0787B2B72DC8D25399DAAE8864B7 │ │ │ │ │ -E84AA99DAFCEAF18F8B41882720316450F1B1CA48B418C9736E5CE4AFF996111 │ │ │ │ │ -5F7FE80958B6A3498508E9693CB134402D92E30D4C2939070D4647E13682290E │ │ │ │ │ -1D0820A3FCA7147157D09D1A40771F214EAE7DD743EA26839E535CA186C05CB8 │ │ │ │ │ -4874988AA1104D85AF0220FE7224344FF624E794BD2454E1C0AC971522FBECBA │ │ │ │ │ -B2497F25CD621B77EC5160973EF5ECC39C183DC051B0DFCB090194A2525BD96E │ │ │ │ │ -28593FDA80D8D259F039416D5F9AF0AD3C9A105B49DAF6E681921E369B7666C6 │ │ │ │ │ -2B73DB37447B00AE96317C2F1C44FB6E6EFD740BAB20FA03A8CE018EC8415582 │ │ │ │ │ -FB06E88A2971E3A480FB1EB4FE93CC7E5179721CAABEE88742B13CF0405F49F4 │ │ │ │ │ -945E587668C821D8C06D6847B6DF84CAFFCD4628670D551FC5F7236875BE1207 │ │ │ │ │ -634BA7F70A19B658FAE7D86F6D00ED28FBF29CC585DEE279325EEF8B0CCB6149 │ │ │ │ │ -E46E638C73D75148F18A636DBC2DD96ED34F68A5A09A3700B1EA34B2D142807C │ │ │ │ │ -F8709D81180783548EAE6F457BF968602076A1069163E3C15BBCEF659C6CF2E6 │ │ │ │ │ -0BB01BDC8E503802CC7969A5B8477E9788C5249B23B19669F5075E089738E49A │ │ │ │ │ -8671D7C1B1B47652F3D78BF2FF74EDB44BA5B092E8D5B85001E97F69D54AEEFC │ │ │ │ │ -88FC3CA1B0D5BAC39263B371005BCFA19AD197A31CC34D0BD55C2CA18C60C485 │ │ │ │ │ -5993F736EF1DD2C5D2B4D50B3D498861B4DF5E7AFF614BBCA4C2E6BECC0DCEF5 │ │ │ │ │ -95F0D686188014C530D8E37650CDCAE721B4AFB0F178BC744BDDDED45DAB7FEB │ │ │ │ │ -A10B975E26099E3DC61116D6BF554574F948895B88EEFE03DCC5351190836AD4 │ │ │ │ │ -EBC1AC55C6D099A8E7B0A372D290C481F44FA464B9C11A0BC991CB045E0AAAC4 │ │ │ │ │ -5C73CA43A4F17D1ADDD33D1B917FF95BFF411C8409F41553B1BC97DE47E3A1F4 │ │ │ │ │ -A5C1D1B7B1BF7E2507AC53956C141411F4F657E37981996DD7BB7ADB2CB6AE01 │ │ │ │ │ -73D0876B8F896F626D5022FE53BA34D5668BD698BE8D5CCAD083CBCEF440BE6A │ │ │ │ │ -8090EB1CDEE5F99C8988650BD4E539B357C31C597D8A9104A9D5967D4E906CAD │ │ │ │ │ -2A65575A884B1C5F6CC509E742FA9DDD66494F219178161AF72C50848E226A95 │ │ │ │ │ -A8C247FF9FF0BABD073021271B5C0692F9BE220071DAB09E5A026629371EE3C4 │ │ │ │ │ -A6E4FA94625D87A5B66EF077ED54C72B1052AEAA9637B30C76EF8EB04AD5F476 │ │ │ │ │ -D15F1C93C0BC6E0F67B366097BBED03FE82C040F9EF02866159B46854E11D44F │ │ │ │ │ -54AE6748A7E61B993A4EECD3B8BE3B5897A66BBCDFE24F65BC2AD5AB49048CF1 │ │ │ │ │ -647203823F84DF5CB483096F9D96AEE3A2855E479B72A14A67C633CE99C101CF │ │ │ │ │ -EFAE939BF9B02E710D │ │ │ │ │ +1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004ACD1870 │ │ │ │ │ +A5EA947858F5795870BFE1343AD803FB854BF8F5A4E794E8EC57BE41DB5B8734 │ │ │ │ │ +13E47950F29A81EA0C81EA798863883D7F41F78325CA190CBBFFE822AE494550 │ │ │ │ │ +4BE83703071FC9512D128927AF3F63CEF8F86ABE1E15D7B4DDD39576E7DFF45E │ │ │ │ │ +3CB4115AAB1830DE8647B915DB4BEBEB5235C281E098B899BAB951D8D5798F01 │ │ │ │ │ +7F7C47336D31438E5126738AFEAB29E9A7CBE06DE4DD604477B542D2620DFD58 │ │ │ │ │ +28FE34238572F23C5A8EB7ACEE1E154DA13FC1A5AA67A3BA8C5CDFB2B80312C9 │ │ │ │ │ +BC9FAE56D08DDFA9498E6EF0D0F6BD18B3923E0B670B0740528BC843610736CB │ │ │ │ │ +80228C105C2F72C3C22D610C3D8C268DEEA2AEEE3221E198E79FE2966487360C │ │ │ │ │ +84AE08AC326F48B21447652121B1EB68AF856055EEA65B6B625BF622CBFC2D1C │ │ │ │ │ +EF943CC4CAF2C715782C9EF9A9BA4689BFC6B6A82F8D55795BE8111E2C7DE520 │ │ │ │ │ +367362304B6A48186C842033E715A46265A352472F4F7313248EBCD26BEA97E7 │ │ │ │ │ +B814A61D4B7ADCB5C5F21AA34E0C1269E8426DBFB511DE6E26B960456C8F8520 │ │ │ │ │ +5F0DD382289A62AF0B935EDB5B2394538C5F0EE72962D2F98F3C38CD7C027B9F │ │ │ │ │ +E230E67E40FEFBDED06B3423C9DFD669E6B5BC913E0FF75786A64A6C11D4FE89 │ │ │ │ │ +1B918DC0E953C52CFD153063CD0D2A78B43F8712243845E6F2CBA1DB610F403D │ │ │ │ │ +A98D06D95FF44C7AC029092B666A8B0DCEA95B34F5ACC10E8611BADE6A24469C │ │ │ │ │ +0C01D95BFB445FA22CD38D033E4D24E006BB9D54EE41EF7AD5AC9C299721F61A │ │ │ │ │ +F01B6EDCDF428BD9195A13C5B1027358F8A203F828A1DD9622243B2D76C6F1BA │ │ │ │ │ +9F2D7E9D4879FC668ABC750CD25415DC6CCF2257C28F78D3F9BE499CC0FF2F80 │ │ │ │ │ +2C2CD1DEFABD6668FCA76E1D629A344333E33DA24B86D2E9F8F5EE1C29974640 │ │ │ │ │ +C3E78E999BAB313400041DADDDFDBFFCC419F129A84F4D412B79E8BE4511CA00 │ │ │ │ │ +F92A4F3CDD2E51345D3965C104F06B6503445DC20224CB7606A9D7D5F9EE45E6 │ │ │ │ │ +1B2963DA96AA2AB1BA5BE29656E666E4D0E122DE58EEA68E04ED76438DA03E65 │ │ │ │ │ +B80055A86B7B2A26BAE6BBB8835E17F9696E9B3CD34571BA75C76D4D2CCC48F1 │ │ │ │ │ +7534C1EF9127E374D65D05B8072E08D6C72A0B4A35EA0DD717743C66D105CCD8 │ │ │ │ │ +7355F13E9C38C1A4351624E689ED7909100942FA0474842EE44DEC3279E1A1CD │ │ │ │ │ +8064666EB845CA7C3E906B67C0BF96A28D514DB2E4A1E4AF287350B03762A2CF │ │ │ │ │ +13B18AC3F5D2F3B74A1D50267C03EFB74B888E1D24ABEEA4A885F4D0BF14C0D8 │ │ │ │ │ +289AC79D6D98E2A2C831672FB1F3457564CD161ADC3AF610D88201AB5B0C10CB │ │ │ │ │ +5ECCC2D5C4AF39C8CB3044BF9EC791BA45D29C2B51EA0483D19822C264CE6FA3 │ │ │ │ │ +5C97F2DF5A78CB93528E99B9ED7CB121C83130C129B849B52A36EBD88AF19DD3 │ │ │ │ │ +C5CABE831027388EF86BD5CBD90AAAC089775938A321C44D4DDA67A51312D8AB │ │ │ │ │ +C509DDBE7044A107AB2BE9C4C9556F85C529B174A7778B489BF28EC07A834542 │ │ │ │ │ +8B31F2925C21FB2096877711F998763D5A8495002B8E080AF8DBB1B3106EDDBA │ │ │ │ │ +35121D52E0846A7AF3ABEDF87BDE4FA665673A9B80CA538B98F873947AA17EF4 │ │ │ │ │ +9BB182917E9D79BC7EC681E93710D6A1D6B0E4A7FA9452FC1C431808174F3AB7 │ │ │ │ │ +F3914FBC86CB34E8583457243C3C7BE4BC166C7397689BC6FFB82EA2967E88EE │ │ │ │ │ +464F96EDA144DE2B64401B8E577ABCA2D826FE0B92E21FFAE3E81EBB6B6EB36E │ │ │ │ │ +9B1A8FE3884CA398C03135FD49D51724FC1268E9482E41FAEA2FC6C809006B8F │ │ │ │ │ +5D4F9E038450AD3A6041C16FD1C7E5FC80C0E033CE57E64863E014531D94DF1E │ │ │ │ │ +31D7D038AFCB60715AA73C1E96F113A24C5AF35BBEB61C4D079ED034ED83AA4A │ │ │ │ │ +E12448E618330463304788BCF40561CD63167B3BF144F408E2B89E60B8BA13EF │ │ │ │ │ +3B57D286FD23D4FA8BAEFF98DC1188B1982956CC1DCAEFC7D949B7B4E3BE8F8A │ │ │ │ │ +BFE2C9D938DD13EFEE7123576608D9396F260907DA98AE2D3DD5822306CBC8A6 │ │ │ │ │ +B083C697DDA3C62EE7879436A9FD8EE0034B105105B3F122F893EA2126EBE8A9 │ │ │ │ │ +5CBF2BD248DD9FBEF0040C25797BD13B69A8C9F0D4E4F935C61ED30487CCDB1A │ │ │ │ │ +0339006E78EE1755929D2412776EC7DB1F666DBDD28EA8AC7397F809C7F38A41 │ │ │ │ │ +5B3BF6C75F4F35C90141EB08377AF452CF840FEA938805F9D14E02DC29215B4E │ │ │ │ │ +F1EB │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ @@ -3303,16 +3294,16 @@ │ │ │ │ │ 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 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 23[45 19[83 │ │ │ │ │ -18[25 2[45 2[45 1[45 45 45 3[25 44[{}10 90.9091 /CMSL10 │ │ │ │ │ +6[28 58[{}16 90.9091 /CMTI10 rf /Ff 138[51 6[51 8[40 │ │ │ │ │ +26[47 15[25 4[45 2[45 1[45 3[25 44[{}9 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 │ │ │ │ │ @@ -3425,20 +3416,20 @@ │ │ │ │ │ (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 1060 4 v │ │ │ │ │ -1242 w Fh(SubMtxList)27 b Ff(:)41 b Fe(DRAFT)30 b Ff(Ma)m(y)i(17,)f │ │ │ │ │ -(2024)p 2841 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 │ │ │ │ │ +TeXDict begin 2 1 bop 0 100 a Fi(2)p 136 100 1053 4 v │ │ │ │ │ +1235 w Fh(SubMtxList)27 b Ff(:)41 b Fe(DRAFT)30 b Ff(June)f(20,)j(2025) │ │ │ │ │ +p 2848 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 │ │ │ │ │ @@ -3488,17 +3479,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 1060 4 v 1241 100 a Fh(SubMtxList)28 │ │ │ │ │ -b Ff(:)40 b Fe(DRAFT)121 b Ff(Ma)m(y)32 b(17,)f(2024)p │ │ │ │ │ -2793 100 V 1060 w Fi(3)111 399 y(3.)46 b Fh(void)h │ │ │ │ │ +TeXDict begin 3 2 bop 91 100 1053 4 v 1234 100 a Fh(SubMtxList)28 │ │ │ │ │ +b Ff(:)40 b Fe(DRAFT)122 b Ff(June)29 b(20,)i(2025)p │ │ │ │ │ +2800 100 V 1053 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 │ │ │ │ │ @@ -3562,19 +3553,19 @@ │ │ │ │ │ (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 1060 4 v │ │ │ │ │ -1242 w Fh(SubMtxList)27 b Ff(:)41 b Fe(DRAFT)30 b Ff(Ma)m(y)i(17,)f │ │ │ │ │ -(2024)p 2841 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 │ │ │ │ │ +TeXDict begin 4 3 bop 0 100 a Fi(4)p 136 100 1053 4 v │ │ │ │ │ +1235 w Fh(SubMtxList)27 b Ff(:)41 b Fe(DRAFT)30 b Ff(June)f(20,)j(2025) │ │ │ │ │ +p 2848 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) │ │ │ │ │ ├── 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 May 17, 2024 │ │ │ │ │ │ + 2 SubMtxList : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 3 │ │ │ │ │ │ + SubMtxList : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 4 SubMtxList : DRAFT June 20, 2025 │ │ │ │ │ │ 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 2024.05.17:2218 │ │ │ │ │ +%DVIPSSource: TeX output 2025.06.20:0450 │ │ │ │ │ %%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 │ │ │ │ │ @@ -1419,22 +1419,21 @@ │ │ │ │ │ /UnderlinePosition -100 def │ │ │ │ │ /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 49 /one put │ │ │ │ │ dup 50 /two put │ │ │ │ │ -dup 52 /four put │ │ │ │ │ -dup 55 /seven put │ │ │ │ │ +dup 53 /five put │ │ │ │ │ dup 58 /colon put │ │ │ │ │ -dup 77 /M put │ │ │ │ │ -dup 97 /a put │ │ │ │ │ -dup 121 /y put │ │ │ │ │ +dup 74 /J put │ │ │ │ │ +dup 101 /e put │ │ │ │ │ +dup 110 /n put │ │ │ │ │ +dup 117 /u put │ │ │ │ │ readonly def │ │ │ │ │ currentdict end │ │ │ │ │ currentfile eexec │ │ │ │ │ D9D66F633B846AB284BCF8B0411B772DE5CE32340DC6F28AF40857E4451976E7 │ │ │ │ │ 5182433CF9F333A38BD841C0D4E68BF9E012EB32A8FFB76B5816306B5EDF7C99 │ │ │ │ │ 8B3A16D9B4BC056662E32C7CD0123DFAEB734C7532E64BBFBF5A60336E646716 │ │ │ │ │ EFB852C877F440D329172C71F1E5D59CE9473C26B8AEF7AD68EF0727B6EC2E0C │ │ │ │ │ @@ -1615,72 +1614,64 @@ │ │ │ │ │ 7CA1534C4D5B05FC33F83790ECFD7641DF3FB94289E2A1F6E7D29AB1228A867A │ │ │ │ │ 6E1EF0E9C6F899B491DC18401C2C0A05FFFED46A72C245F7529B8EA55A038082 │ │ │ │ │ 8512307217D2A233C37004085BA3AEE379269F9FA7D0ADB4B19A95CC2AFE686E │ │ │ │ │ 55D88E47257C1FE6F235FEA295910569FE6DD5995512562359CC821E85A6C7A5 │ │ │ │ │ 79B470A9E340A6985189FF8B6AF914A6B0ECF93F47903221F95DE894A8F05B05 │ │ │ │ │ B7D99CD533EC5F931B18E6B39BECF67FA2D6DD1AEC76772B068BE06335A94C05 │ │ │ │ │ 7A4DDEE77B66101DA855C17AC312600370B34E31F5EC3A01300A8EB60B4C9767 │ │ │ │ │ -1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004B9BA1CC │ │ │ │ │ -580D3C6BDA4DC1B80B4365F1C80512453FC5316EC2D928FB731C3D6403E3C18B │ │ │ │ │ -E8424D644DF5E9A2134229C5C91CA68DB8E85BA2BB40F538F585DA6FA4037718 │ │ │ │ │ -B8053EBBA1E765346BCD5BDAA6C38115D31611D8A87A2238C145F2DA2F92E4DF │ │ │ │ │ -3987BD9C4D2A3D460E8941A68B125BCD9EE4F9FD262C4C8A71F47A2C81975635 │ │ │ │ │ -F1B981C274C53FA2ACCDE4C9D0A7C62D6C1EFF91CFC6712CA6A9F333C9564FCB │ │ │ │ │ -2A70F0AD715A79B10A08AB069E2A3C93BC0AED19D0CA10134B8DDDE8AF548DB2 │ │ │ │ │ -3A4AAA9C29682CF135BB767DAA16169A127EB50A7EECEB6480CF56A7D0F8AC56 │ │ │ │ │ -4A5090B3D75A790372886AF568D94C8165975A05BFBFDF1FFBA45F70700BB9E0 │ │ │ │ │ -57F3249EF9E9C8AD9CBCF6E4FD592DC4CDD2CC7C0BC3130C1059096C657BE453 │ │ │ │ │ -A2CBACE93420210E27AF56CA229BD6D982FB68B3FDC6D44478B922C4231C47EE │ │ │ │ │ -E500232F6C11D92DEB955F66DF52B92B22E7352790CC2DCBAC53965D57AC2920 │ │ │ │ │ -68B7D520DE25047146EFEB06B9AD4E2A94243C7E5239F0BC2FC312B16051D52C │ │ │ │ │ -0B92C217B6B42997321AE4F8BB066754B7AA3F15069EF59224E8A442CE471AA7 │ │ │ │ │ -E8049A3DD9EDA09CCEE4998998661CF7DB35E952F6C65DAEB3013951C59F3E09 │ │ │ │ │ -157F313B0237876E1C0190F0473819570B8C0205AADF05D787CC00979CFB327A │ │ │ │ │ -289382B22DDA6F12804ED0ED5B179E36A995A2A59E1B66E75130DBE9109C813B │ │ │ │ │ -94403E0DEA8314A1E9DB474D7FA83C0BAFD08033E6A6215844C1D26BE15F1251 │ │ │ │ │ -A1605E8DF9A9C601ED37379530BC1C82BE5463C6C711C5652BFD6262485AA9CA │ │ │ │ │ -B8C4A117593001D08D980041E2A83C190DCE8E6CD3D334E5CC19FC05DB30F7F7 │ │ │ │ │ -24A305C4DBB31F0651392B99D44B4302333BDF7E326FD256DD75D309C6E73F85 │ │ │ │ │ -FA71B35FD1F9BEFF4C7A1076362EEB0A85492933B6006086A7B8C1928CF2D1EE │ │ │ │ │ -FD4344409257BB802C117E739960821CD3C88BFBA5669FF16F610AD638AF3677 │ │ │ │ │ -8674C985E6767253ED5769F71BEA5E9BB02A751F9E62EE2B18AC19D975FDEAE9 │ │ │ │ │ -8B8822367FF177A7E850766DE99ED3366D46464612926430012212A90F8E85F4 │ │ │ │ │ -4760B40D5B86B90819EE410382C23E86DCAF4F0FF5DFEB2C285965F4DCF2FB2B │ │ │ │ │ -457C0A0427A8D4ADA514E9DACD0F9367E1DA225DB21DA4DDAE33F2B529686D92 │ │ │ │ │ -AC085B345565F9DFFA012FD494DBB2E0B44A0787B2B72DC8D25399DAAE8864B7 │ │ │ │ │ -E84AA99DAFCEAF18F8B41882720316450F1B1CA48B418C9736E5CE4AFF996111 │ │ │ │ │ -5F7FE80958B6A3498508E9693CB134402D92E30D4C2939070D4647E13682290E │ │ │ │ │ -1D0820A3FCA7147157D09D1A40771F214EAE7DD743EA26839E535CA186C05CB8 │ │ │ │ │ -4874988AA1104D85AF0220FE7224344FF624E794BD2454E1C0AC971522FBECBA │ │ │ │ │ -B2497F25CD621B77EC5160973EF5ECC39C183DC051B0DFCB090194A2525BD96E │ │ │ │ │ -28593FDA80D8D259F039416D5F9AF0AD3C9A105B49DAF6E681921E369B7666C6 │ │ │ │ │ -2B73DB37447B00AE96317C2F1C44FB6E6EFD740BAB20FA03A8CE018EC8415582 │ │ │ │ │ -FB06E88A2971E3A480FB1EB4FE93CC7E5179721CAABEE88742B13CF0405F49F4 │ │ │ │ │ -945E587668C821D8C06D6847B6DF84CAFFCD4628670D551FC5F7236875BE1207 │ │ │ │ │ -634BA7F70A19B658FAE7D86F6D00ED28FBF29CC585DEE279325EEF8B0CCB6149 │ │ │ │ │ -E46E638C73D75148F18A636DBC2DD96ED34F68A5A09A3700B1EA34B2D142807C │ │ │ │ │ -F8709D81180783548EAE6F457BF968602076A1069163E3C15BBCEF659C6CF2E6 │ │ │ │ │ -0BB01BDC8E503802CC7969A5B8477E9788C5249B23B19669F5075E089738E49A │ │ │ │ │ -8671D7C1B1B47652F3D78BF2FF74EDB44BA5B092E8D5B85001E97F69D54AEEFC │ │ │ │ │ -88FC3CA1B0D5BAC39263B371005BCFA19AD197A31CC34D0BD55C2CA18C60C485 │ │ │ │ │ -5993F736EF1DD2C5D2B4D50B3D498861B4DF5E7AFF614BBCA4C2E6BECC0DCEF5 │ │ │ │ │ -95F0D686188014C530D8E37650CDCAE721B4AFB0F178BC744BDDDED45DAB7FEB │ │ │ │ │ -A10B975E26099E3DC61116D6BF554574F948895B88EEFE03DCC5351190836AD4 │ │ │ │ │ -EBC1AC55C6D099A8E7B0A372D290C481F44FA464B9C11A0BC991CB045E0AAAC4 │ │ │ │ │ -5C73CA43A4F17D1ADDD33D1B917FF95BFF411C8409F41553B1BC97DE47E3A1F4 │ │ │ │ │ -A5C1D1B7B1BF7E2507AC53956C141411F4F657E37981996DD7BB7ADB2CB6AE01 │ │ │ │ │ -73D0876B8F896F626D5022FE53BA34D5668BD698BE8D5CCAD083CBCEF440BE6A │ │ │ │ │ -8090EB1CDEE5F99C8988650BD4E539B357C31C597D8A9104A9D5967D4E906CAD │ │ │ │ │ -2A65575A884B1C5F6CC509E742FA9DDD66494F219178161AF72C50848E226A95 │ │ │ │ │ -A8C247FF9FF0BABD073021271B5C0692F9BE220071DAB09E5A026629371EE3C4 │ │ │ │ │ -A6E4FA94625D87A5B66EF077ED54C72B1052AEAA9637B30C76EF8EB04AD5F476 │ │ │ │ │ -D15F1C93C0BC6E0F67B366097BBED03FE82C040F9EF02866159B46854E11D44F │ │ │ │ │ -54AE6748A7E61B993A4EECD3B8BE3B5897A66BBCDFE24F65BC2AD5AB49048CF1 │ │ │ │ │ -647203823F84DF5CB483096F9D96AEE3A2855E479B72A14A67C633CE99C101CF │ │ │ │ │ -EFAE939BF9B02E710D │ │ │ │ │ +1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004ACD1870 │ │ │ │ │ +A5EA947858F5795870BFE1343AD803FB854BF8F5A4E794E8EC57BE41DB5B8734 │ │ │ │ │ +13E47950F29A81EA0C81EA798863883D7F41F78325CA190CBBFFE822AE494550 │ │ │ │ │ +4BE83703071FC9512D128927AF3F63CEF8F86ABE1E15D7B4DDD39576E7DFF45E │ │ │ │ │ +3CB4115AAB1830DE8647B915DB4BEBEB5235C281E098B899BAB951D8D5798F01 │ │ │ │ │ +7F7C47336D31438E5126738AFEAB29E9A7CBE06DE4DD604477B542D2620DFD58 │ │ │ │ │ +28FE34238572F23C5A8EB7ACEE1E154DA13FC1A5AA67A3BA8C5CDFB2B80312C9 │ │ │ │ │ +BC9FAE56D08DDFA9498E6EF0D0F6BD18B3923E0B670B0740528BC843610736CB │ │ │ │ │ +80228C105C2F72C3C22D610C3D8C268DEEA2AEEE3221E198E79FE2966487360C │ │ │ │ │ +84AE08AC326F48B21447652121B1EB68AF856055EEA65B6B625BF622CBFC2D1C │ │ │ │ │ +EF943CC4CAF2C715782C9EF9A9BA4689BFC6B6A82F8D55795BE8111E2C7DE520 │ │ │ │ │ +367362304B6A48186C842033E715A46265A352472F4F7313248EBCD26BEA97E7 │ │ │ │ │ +B814A61D4B7ADCB5C5F21AA34E0C1269E8426DBFB511DE6E26B960456C8F8520 │ │ │ │ │ +5F0DD382289A62AF0B935EDB5B2394538C5F0EE72962D2F98F3C38CD7C027B9F │ │ │ │ │ +E230E67E40FEFBDED06B3423C9DFD669E6B5BC913E0FF75786A64A6C11D4FE89 │ │ │ │ │ +1B918DC0E953C52CFD153063CD0D2A78B43F8712243845E6F2CBA1DB610F403D │ │ │ │ │ +A98D06D95FF44C7AC029092B666A8B0DCEA95B34F5ACC10E8611BADE6A24469C │ │ │ │ │ +0C01D95BFB445FA22CD38D033E4D24E006BB9D54EE41EF7AD5AC9C299721F61A │ │ │ │ │ +F01B6EDCDF428BD9195A13C5B1027358F8A203F828A1DD9622243B2D76C6F1BA │ │ │ │ │ +9F2D7E9D4879FC668ABC750CD25415DC6CCF2257C28F78D3F9BE499CC0FF2F80 │ │ │ │ │ +2C2CD1DEFABD6668FCA76E1D629A344333E33DA24B86D2E9F8F5EE1C29974640 │ │ │ │ │ +C3E78E999BAB313400041DADDDFDBFFCC419F129A84F4D412B79E8BE4511CA00 │ │ │ │ │ +F92A4F3CDD2E51345D3965C104F06B6503445DC20224CB7606A9D7D5F9EE45E6 │ │ │ │ │ +1B2963DA96AA2AB1BA5BE29656E666E4D0E122DE58EEA68E04ED76438DA03E65 │ │ │ │ │ +B80055A86B7B2A26BAE6BBB8835E17F9696E9B3CD34571BA75C76D4D2CCC48F1 │ │ │ │ │ +7534C1EF9127E374D65D05B8072E08D6C72A0B4A35EA0DD717743C66D105CCD8 │ │ │ │ │ +7355F13E9C38C1A4351624E689ED7909100942FA0474842EE44DEC3279E1A1CD │ │ │ │ │ +8064666EB845CA7C3E906B67C0BF96A28D514DB2E4A1E4AF287350B03762A2CF │ │ │ │ │ +13B18AC3F5D2F3B74A1D50267C03EFB74B888E1D24ABEEA4A885F4D0BF14C0D8 │ │ │ │ │ +289AC79D6D98E2A2C831672FB1F3457564CD161ADC3AF610D88201AB5B0C10CB │ │ │ │ │ +5ECCC2D5C4AF39C8CB3044BF9EC791BA45D29C2B51EA0483D19822C264CE6FA3 │ │ │ │ │ +5C97F2DF5A78CB93528E99B9ED7CB121C83130C129B849B52A36EBD88AF19DD3 │ │ │ │ │ +C5CABE831027388EF86BD5CBD90AAAC089775938A321C44D4DDA67A51312D8AB │ │ │ │ │ +C509DDBE7044A107AB2BE9C4C9556F85C529B174A7778B489BF28EC07A834542 │ │ │ │ │ +8B31F2925C21FB2096877711F998763D5A8495002B8E080AF8DBB1B3106EDDBA │ │ │ │ │ +35121D52E0846A7AF3ABEDF87BDE4FA665673A9B80CA538B98F873947AA17EF4 │ │ │ │ │ +9BB182917E9D79BC7EC681E93710D6A1D6B0E4A7FA9452FC1C431808174F3AB7 │ │ │ │ │ +F3914FBC86CB34E8583457243C3C7BE4BC166C7397689BC6FFB82EA2967E88EE │ │ │ │ │ +464F96EDA144DE2B64401B8E577ABCA2D826FE0B92E21FFAE3E81EBB6B6EB36E │ │ │ │ │ +9B1A8FE3884CA398C03135FD49D51724FC1268E9482E41FAEA2FC6C809006B8F │ │ │ │ │ +5D4F9E038450AD3A6041C16FD1C7E5FC80C0E033CE57E64863E014531D94DF1E │ │ │ │ │ +31D7D038AFCB60715AA73C1E96F113A24C5AF35BBEB61C4D079ED034ED83AA4A │ │ │ │ │ +E12448E618330463304788BCF40561CD63167B3BF144F408E2B89E60B8BA13EF │ │ │ │ │ +3B57D286FD23D4FA8BAEFF98DC1188B1982956CC1DCAEFC7D949B7B4E3BE8F8A │ │ │ │ │ +BFE2C9D938DD13EFEE7123576608D9396F260907DA98AE2D3DD5822306CBC8A6 │ │ │ │ │ +B083C697DDA3C62EE7879436A9FD8EE0034B105105B3F122F893EA2126EBE8A9 │ │ │ │ │ +5CBF2BD248DD9FBEF0040C25797BD13B69A8C9F0D4E4F935C61ED30487CCDB1A │ │ │ │ │ +0339006E78EE1755929D2412776EC7DB1F666DBDD28EA8AC7397F809C7F38A41 │ │ │ │ │ +5B3BF6C75F4F35C90141EB08377AF452CF840FEA938805F9D14E02DC29215B4E │ │ │ │ │ +F1EB │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ @@ -3848,16 +3839,16 @@ │ │ │ │ │ TeXDict begin 40258437 52099151 1000 600 600 (main.dvi) │ │ │ │ │ @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 │ │ │ │ │ -23[45 19[83 18[25 2[45 2[45 1[45 45 45 3[25 44[{}10 90.9091 │ │ │ │ │ +11[103 17[67 67 2[37 46[{}22 119.552 /CMBX12 rf /Fe 138[51 │ │ │ │ │ +6[51 8[40 26[47 15[25 4[45 2[45 1[45 3[25 44[{}9 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 │ │ │ │ │ @@ -3993,17 +3984,17 @@ │ │ │ │ │ (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 988 4 v │ │ │ │ │ -1170 w Fj(SubMtxManager)27 b Fe(:)40 b Fh(DRAFT)31 b │ │ │ │ │ -Fe(Ma)m(y)g(17,)h(2024)p 2912 100 V 141 399 a Fk(Eac)m(h)21 │ │ │ │ │ +TeXDict begin 2 1 bop 0 100 a Fk(2)p 136 100 981 4 v │ │ │ │ │ +1163 w Fj(SubMtxManager)27 b Fe(:)40 b Fh(DRAFT)31 b │ │ │ │ │ +Fe(June)e(20,)j(2025)p 2919 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 │ │ │ │ │ @@ -4052,17 +4043,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 988 4 v 1169 100 a Fj(SubMtxManager)27 │ │ │ │ │ -b Fe(:)41 b Fh(DRAFT)121 b Fe(Ma)m(y)32 b(17,)f(2024)p │ │ │ │ │ -2865 100 V 988 w Fk(3)111 399 y(2.)46 b Fj(void)h │ │ │ │ │ +TeXDict begin 3 2 bop 91 100 981 4 v 1163 100 a Fj(SubMtxManager)26 │ │ │ │ │ +b Fe(:)41 b Fh(DRAFT)121 b Fe(June)30 b(20,)h(2025)p │ │ │ │ │ +2872 100 V 981 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 │ │ │ │ │ @@ -4125,17 +4116,17 @@ │ │ │ │ │ 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 988 4 v │ │ │ │ │ -1170 w Fj(SubMtxManager)27 b Fe(:)40 b Fh(DRAFT)31 b │ │ │ │ │ -Fe(Ma)m(y)g(17,)h(2024)p 2912 100 V 111 399 a Fk(3.)46 │ │ │ │ │ +TeXDict begin 4 3 bop 0 100 a Fk(4)p 136 100 981 4 v │ │ │ │ │ +1163 w Fj(SubMtxManager)27 b Fe(:)40 b Fh(DRAFT)31 b │ │ │ │ │ +Fe(June)e(20,)j(2025)p 2919 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 │ │ │ │ │ ├── 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 May 17, 2024 │ │ │ │ │ │ + 2 SubMtxManager : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 3 │ │ │ │ │ │ + SubMtxManager : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 4 SubMtxManager : DRAFT June 20, 2025 │ │ │ │ │ │ 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 2024.05.17:2218 │ │ │ │ │ +%DVIPSSource: TeX output 2025.06.20:0450 │ │ │ │ │ %%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 │ │ │ │ │ @@ -1006,22 +1006,21 @@ │ │ │ │ │ /UnderlinePosition -100 def │ │ │ │ │ /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 49 /one put │ │ │ │ │ dup 50 /two put │ │ │ │ │ -dup 52 /four put │ │ │ │ │ -dup 55 /seven put │ │ │ │ │ +dup 53 /five put │ │ │ │ │ dup 58 /colon put │ │ │ │ │ -dup 77 /M put │ │ │ │ │ -dup 97 /a put │ │ │ │ │ -dup 121 /y put │ │ │ │ │ +dup 74 /J put │ │ │ │ │ +dup 101 /e put │ │ │ │ │ +dup 110 /n put │ │ │ │ │ +dup 117 /u put │ │ │ │ │ readonly def │ │ │ │ │ currentdict end │ │ │ │ │ currentfile eexec │ │ │ │ │ D9D66F633B846AB284BCF8B0411B772DE5CE32340DC6F28AF40857E4451976E7 │ │ │ │ │ 5182433CF9F333A38BD841C0D4E68BF9E012EB32A8FFB76B5816306B5EDF7C99 │ │ │ │ │ 8B3A16D9B4BC056662E32C7CD0123DFAEB734C7532E64BBFBF5A60336E646716 │ │ │ │ │ EFB852C877F440D329172C71F1E5D59CE9473C26B8AEF7AD68EF0727B6EC2E0C │ │ │ │ │ @@ -1202,72 +1201,64 @@ │ │ │ │ │ 7CA1534C4D5B05FC33F83790ECFD7641DF3FB94289E2A1F6E7D29AB1228A867A │ │ │ │ │ 6E1EF0E9C6F899B491DC18401C2C0A05FFFED46A72C245F7529B8EA55A038082 │ │ │ │ │ 8512307217D2A233C37004085BA3AEE379269F9FA7D0ADB4B19A95CC2AFE686E │ │ │ │ │ 55D88E47257C1FE6F235FEA295910569FE6DD5995512562359CC821E85A6C7A5 │ │ │ │ │ 79B470A9E340A6985189FF8B6AF914A6B0ECF93F47903221F95DE894A8F05B05 │ │ │ │ │ B7D99CD533EC5F931B18E6B39BECF67FA2D6DD1AEC76772B068BE06335A94C05 │ │ │ │ │ 7A4DDEE77B66101DA855C17AC312600370B34E31F5EC3A01300A8EB60B4C9767 │ │ │ │ │ -1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004B9BA1CC │ │ │ │ │ -580D3C6BDA4DC1B80B4365F1C80512453FC5316EC2D928FB731C3D6403E3C18B │ │ │ │ │ -E8424D644DF5E9A2134229C5C91CA68DB8E85BA2BB40F538F585DA6FA4037718 │ │ │ │ │ -B8053EBBA1E765346BCD5BDAA6C38115D31611D8A87A2238C145F2DA2F92E4DF │ │ │ │ │ -3987BD9C4D2A3D460E8941A68B125BCD9EE4F9FD262C4C8A71F47A2C81975635 │ │ │ │ │ -F1B981C274C53FA2ACCDE4C9D0A7C62D6C1EFF91CFC6712CA6A9F333C9564FCB │ │ │ │ │ -2A70F0AD715A79B10A08AB069E2A3C93BC0AED19D0CA10134B8DDDE8AF548DB2 │ │ │ │ │ -3A4AAA9C29682CF135BB767DAA16169A127EB50A7EECEB6480CF56A7D0F8AC56 │ │ │ │ │ -4A5090B3D75A790372886AF568D94C8165975A05BFBFDF1FFBA45F70700BB9E0 │ │ │ │ │ -57F3249EF9E9C8AD9CBCF6E4FD592DC4CDD2CC7C0BC3130C1059096C657BE453 │ │ │ │ │ -A2CBACE93420210E27AF56CA229BD6D982FB68B3FDC6D44478B922C4231C47EE │ │ │ │ │ -E500232F6C11D92DEB955F66DF52B92B22E7352790CC2DCBAC53965D57AC2920 │ │ │ │ │ -68B7D520DE25047146EFEB06B9AD4E2A94243C7E5239F0BC2FC312B16051D52C │ │ │ │ │ -0B92C217B6B42997321AE4F8BB066754B7AA3F15069EF59224E8A442CE471AA7 │ │ │ │ │ -E8049A3DD9EDA09CCEE4998998661CF7DB35E952F6C65DAEB3013951C59F3E09 │ │ │ │ │ -157F313B0237876E1C0190F0473819570B8C0205AADF05D787CC00979CFB327A │ │ │ │ │ -289382B22DDA6F12804ED0ED5B179E36A995A2A59E1B66E75130DBE9109C813B │ │ │ │ │ -94403E0DEA8314A1E9DB474D7FA83C0BAFD08033E6A6215844C1D26BE15F1251 │ │ │ │ │ -A1605E8DF9A9C601ED37379530BC1C82BE5463C6C711C5652BFD6262485AA9CA │ │ │ │ │ -B8C4A117593001D08D980041E2A83C190DCE8E6CD3D334E5CC19FC05DB30F7F7 │ │ │ │ │ -24A305C4DBB31F0651392B99D44B4302333BDF7E326FD256DD75D309C6E73F85 │ │ │ │ │ -FA71B35FD1F9BEFF4C7A1076362EEB0A85492933B6006086A7B8C1928CF2D1EE │ │ │ │ │ -FD4344409257BB802C117E739960821CD3C88BFBA5669FF16F610AD638AF3677 │ │ │ │ │ -8674C985E6767253ED5769F71BEA5E9BB02A751F9E62EE2B18AC19D975FDEAE9 │ │ │ │ │ -8B8822367FF177A7E850766DE99ED3366D46464612926430012212A90F8E85F4 │ │ │ │ │ -4760B40D5B86B90819EE410382C23E86DCAF4F0FF5DFEB2C285965F4DCF2FB2B │ │ │ │ │ -457C0A0427A8D4ADA514E9DACD0F9367E1DA225DB21DA4DDAE33F2B529686D92 │ │ │ │ │ -AC085B345565F9DFFA012FD494DBB2E0B44A0787B2B72DC8D25399DAAE8864B7 │ │ │ │ │ -E84AA99DAFCEAF18F8B41882720316450F1B1CA48B418C9736E5CE4AFF996111 │ │ │ │ │ -5F7FE80958B6A3498508E9693CB134402D92E30D4C2939070D4647E13682290E │ │ │ │ │ -1D0820A3FCA7147157D09D1A40771F214EAE7DD743EA26839E535CA186C05CB8 │ │ │ │ │ -4874988AA1104D85AF0220FE7224344FF624E794BD2454E1C0AC971522FBECBA │ │ │ │ │ -B2497F25CD621B77EC5160973EF5ECC39C183DC051B0DFCB090194A2525BD96E │ │ │ │ │ -28593FDA80D8D259F039416D5F9AF0AD3C9A105B49DAF6E681921E369B7666C6 │ │ │ │ │ -2B73DB37447B00AE96317C2F1C44FB6E6EFD740BAB20FA03A8CE018EC8415582 │ │ │ │ │ -FB06E88A2971E3A480FB1EB4FE93CC7E5179721CAABEE88742B13CF0405F49F4 │ │ │ │ │ -945E587668C821D8C06D6847B6DF84CAFFCD4628670D551FC5F7236875BE1207 │ │ │ │ │ -634BA7F70A19B658FAE7D86F6D00ED28FBF29CC585DEE279325EEF8B0CCB6149 │ │ │ │ │ -E46E638C73D75148F18A636DBC2DD96ED34F68A5A09A3700B1EA34B2D142807C │ │ │ │ │ -F8709D81180783548EAE6F457BF968602076A1069163E3C15BBCEF659C6CF2E6 │ │ │ │ │ -0BB01BDC8E503802CC7969A5B8477E9788C5249B23B19669F5075E089738E49A │ │ │ │ │ -8671D7C1B1B47652F3D78BF2FF74EDB44BA5B092E8D5B85001E97F69D54AEEFC │ │ │ │ │ -88FC3CA1B0D5BAC39263B371005BCFA19AD197A31CC34D0BD55C2CA18C60C485 │ │ │ │ │ -5993F736EF1DD2C5D2B4D50B3D498861B4DF5E7AFF614BBCA4C2E6BECC0DCEF5 │ │ │ │ │ -95F0D686188014C530D8E37650CDCAE721B4AFB0F178BC744BDDDED45DAB7FEB │ │ │ │ │ -A10B975E26099E3DC61116D6BF554574F948895B88EEFE03DCC5351190836AD4 │ │ │ │ │ -EBC1AC55C6D099A8E7B0A372D290C481F44FA464B9C11A0BC991CB045E0AAAC4 │ │ │ │ │ -5C73CA43A4F17D1ADDD33D1B917FF95BFF411C8409F41553B1BC97DE47E3A1F4 │ │ │ │ │ -A5C1D1B7B1BF7E2507AC53956C141411F4F657E37981996DD7BB7ADB2CB6AE01 │ │ │ │ │ -73D0876B8F896F626D5022FE53BA34D5668BD698BE8D5CCAD083CBCEF440BE6A │ │ │ │ │ -8090EB1CDEE5F99C8988650BD4E539B357C31C597D8A9104A9D5967D4E906CAD │ │ │ │ │ -2A65575A884B1C5F6CC509E742FA9DDD66494F219178161AF72C50848E226A95 │ │ │ │ │ -A8C247FF9FF0BABD073021271B5C0692F9BE220071DAB09E5A026629371EE3C4 │ │ │ │ │ -A6E4FA94625D87A5B66EF077ED54C72B1052AEAA9637B30C76EF8EB04AD5F476 │ │ │ │ │ -D15F1C93C0BC6E0F67B366097BBED03FE82C040F9EF02866159B46854E11D44F │ │ │ │ │ -54AE6748A7E61B993A4EECD3B8BE3B5897A66BBCDFE24F65BC2AD5AB49048CF1 │ │ │ │ │ -647203823F84DF5CB483096F9D96AEE3A2855E479B72A14A67C633CE99C101CF │ │ │ │ │ -EFAE939BF9B02E710D │ │ │ │ │ +1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004ACD1870 │ │ │ │ │ +A5EA947858F5795870BFE1343AD803FB854BF8F5A4E794E8EC57BE41DB5B8734 │ │ │ │ │ +13E47950F29A81EA0C81EA798863883D7F41F78325CA190CBBFFE822AE494550 │ │ │ │ │ +4BE83703071FC9512D128927AF3F63CEF8F86ABE1E15D7B4DDD39576E7DFF45E │ │ │ │ │ +3CB4115AAB1830DE8647B915DB4BEBEB5235C281E098B899BAB951D8D5798F01 │ │ │ │ │ +7F7C47336D31438E5126738AFEAB29E9A7CBE06DE4DD604477B542D2620DFD58 │ │ │ │ │ +28FE34238572F23C5A8EB7ACEE1E154DA13FC1A5AA67A3BA8C5CDFB2B80312C9 │ │ │ │ │ +BC9FAE56D08DDFA9498E6EF0D0F6BD18B3923E0B670B0740528BC843610736CB │ │ │ │ │ +80228C105C2F72C3C22D610C3D8C268DEEA2AEEE3221E198E79FE2966487360C │ │ │ │ │ +84AE08AC326F48B21447652121B1EB68AF856055EEA65B6B625BF622CBFC2D1C │ │ │ │ │ +EF943CC4CAF2C715782C9EF9A9BA4689BFC6B6A82F8D55795BE8111E2C7DE520 │ │ │ │ │ +367362304B6A48186C842033E715A46265A352472F4F7313248EBCD26BEA97E7 │ │ │ │ │ +B814A61D4B7ADCB5C5F21AA34E0C1269E8426DBFB511DE6E26B960456C8F8520 │ │ │ │ │ +5F0DD382289A62AF0B935EDB5B2394538C5F0EE72962D2F98F3C38CD7C027B9F │ │ │ │ │ +E230E67E40FEFBDED06B3423C9DFD669E6B5BC913E0FF75786A64A6C11D4FE89 │ │ │ │ │ +1B918DC0E953C52CFD153063CD0D2A78B43F8712243845E6F2CBA1DB610F403D │ │ │ │ │ +A98D06D95FF44C7AC029092B666A8B0DCEA95B34F5ACC10E8611BADE6A24469C │ │ │ │ │ +0C01D95BFB445FA22CD38D033E4D24E006BB9D54EE41EF7AD5AC9C299721F61A │ │ │ │ │ +F01B6EDCDF428BD9195A13C5B1027358F8A203F828A1DD9622243B2D76C6F1BA │ │ │ │ │ +9F2D7E9D4879FC668ABC750CD25415DC6CCF2257C28F78D3F9BE499CC0FF2F80 │ │ │ │ │ +2C2CD1DEFABD6668FCA76E1D629A344333E33DA24B86D2E9F8F5EE1C29974640 │ │ │ │ │ +C3E78E999BAB313400041DADDDFDBFFCC419F129A84F4D412B79E8BE4511CA00 │ │ │ │ │ +F92A4F3CDD2E51345D3965C104F06B6503445DC20224CB7606A9D7D5F9EE45E6 │ │ │ │ │ +1B2963DA96AA2AB1BA5BE29656E666E4D0E122DE58EEA68E04ED76438DA03E65 │ │ │ │ │ +B80055A86B7B2A26BAE6BBB8835E17F9696E9B3CD34571BA75C76D4D2CCC48F1 │ │ │ │ │ +7534C1EF9127E374D65D05B8072E08D6C72A0B4A35EA0DD717743C66D105CCD8 │ │ │ │ │ +7355F13E9C38C1A4351624E689ED7909100942FA0474842EE44DEC3279E1A1CD │ │ │ │ │ +8064666EB845CA7C3E906B67C0BF96A28D514DB2E4A1E4AF287350B03762A2CF │ │ │ │ │ +13B18AC3F5D2F3B74A1D50267C03EFB74B888E1D24ABEEA4A885F4D0BF14C0D8 │ │ │ │ │ +289AC79D6D98E2A2C831672FB1F3457564CD161ADC3AF610D88201AB5B0C10CB │ │ │ │ │ +5ECCC2D5C4AF39C8CB3044BF9EC791BA45D29C2B51EA0483D19822C264CE6FA3 │ │ │ │ │ +5C97F2DF5A78CB93528E99B9ED7CB121C83130C129B849B52A36EBD88AF19DD3 │ │ │ │ │ +C5CABE831027388EF86BD5CBD90AAAC089775938A321C44D4DDA67A51312D8AB │ │ │ │ │ +C509DDBE7044A107AB2BE9C4C9556F85C529B174A7778B489BF28EC07A834542 │ │ │ │ │ +8B31F2925C21FB2096877711F998763D5A8495002B8E080AF8DBB1B3106EDDBA │ │ │ │ │ +35121D52E0846A7AF3ABEDF87BDE4FA665673A9B80CA538B98F873947AA17EF4 │ │ │ │ │ +9BB182917E9D79BC7EC681E93710D6A1D6B0E4A7FA9452FC1C431808174F3AB7 │ │ │ │ │ +F3914FBC86CB34E8583457243C3C7BE4BC166C7397689BC6FFB82EA2967E88EE │ │ │ │ │ +464F96EDA144DE2B64401B8E577ABCA2D826FE0B92E21FFAE3E81EBB6B6EB36E │ │ │ │ │ +9B1A8FE3884CA398C03135FD49D51724FC1268E9482E41FAEA2FC6C809006B8F │ │ │ │ │ +5D4F9E038450AD3A6041C16FD1C7E5FC80C0E033CE57E64863E014531D94DF1E │ │ │ │ │ +31D7D038AFCB60715AA73C1E96F113A24C5AF35BBEB61C4D079ED034ED83AA4A │ │ │ │ │ +E12448E618330463304788BCF40561CD63167B3BF144F408E2B89E60B8BA13EF │ │ │ │ │ +3B57D286FD23D4FA8BAEFF98DC1188B1982956CC1DCAEFC7D949B7B4E3BE8F8A │ │ │ │ │ +BFE2C9D938DD13EFEE7123576608D9396F260907DA98AE2D3DD5822306CBC8A6 │ │ │ │ │ +B083C697DDA3C62EE7879436A9FD8EE0034B105105B3F122F893EA2126EBE8A9 │ │ │ │ │ +5CBF2BD248DD9FBEF0040C25797BD13B69A8C9F0D4E4F935C61ED30487CCDB1A │ │ │ │ │ +0339006E78EE1755929D2412776EC7DB1F666DBDD28EA8AC7397F809C7F38A41 │ │ │ │ │ +5B3BF6C75F4F35C90141EB08377AF452CF840FEA938805F9D14E02DC29215B4E │ │ │ │ │ +F1EB │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ @@ -3949,38 +3940,38 @@ │ │ │ │ │ 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 23[45 19[83 18[25 2[45 2[45 1[45 45 45 │ │ │ │ │ -3[25 44[{}10 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 │ │ │ │ │ -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 133[48 48 48 48 48 48 48 48 48 │ │ │ │ │ -1[48 48 48 48 48 2[48 48 48 48 48 48 48 48 48 1[48 1[48 │ │ │ │ │ -1[48 1[48 48 1[48 48 48 48 48 1[48 48 48 48 48 1[48 48 │ │ │ │ │ -48 48 48 48 48 48 48 48 2[48 2[48 12[48 48 48 1[48 48 │ │ │ │ │ -48 1[48 38[{}57 90.9091 /CMTT10 rf /Fk 131[91 1[40 48 │ │ │ │ │ -48 66 48 51 35 36 36 48 51 45 51 76 25 48 28 25 51 45 │ │ │ │ │ -28 40 51 40 51 45 9[93 2[66 3[62 71 2[57 2[33 3[62 2[64 │ │ │ │ │ -4[71 1[25 5[45 45 45 45 45 2[25 30 25 2[35 35 25 24[76 │ │ │ │ │ -1[51 53 11[{}51 90.9091 /CMR10 rf /Fl 133[103 123 123 │ │ │ │ │ -3[90 1[95 2[116 129 194 65 2[65 3[106 129 103 129 113 │ │ │ │ │ -13[129 9[87 2[146 11[65 58[{}19 206.559 /CMBX12 rf /Fm │ │ │ │ │ -134[106 11[106 9[106 106 106 13[106 12[106 70[{}7 206.559 │ │ │ │ │ -/CMTT12 rf /Fn 139[75 1[79 1[108 7[108 2[88 3[94 29[140 │ │ │ │ │ -17[97 49[{}8 172.188 /CMBX12 rf end │ │ │ │ │ +rf /Fc 138[51 6[51 8[40 26[47 15[25 4[45 2[45 1[45 3[25 │ │ │ │ │ +44[{}9 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 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 133[48 48 48 48 48 48 48 48 48 1[48 48 48 48 48 │ │ │ │ │ +2[48 48 48 48 48 48 48 48 48 1[48 1[48 1[48 1[48 48 1[48 │ │ │ │ │ +48 48 48 48 1[48 48 48 48 48 1[48 48 48 48 48 48 48 48 │ │ │ │ │ +48 48 2[48 2[48 12[48 48 48 1[48 48 48 1[48 38[{}57 90.9091 │ │ │ │ │ +/CMTT10 rf /Fk 131[91 1[40 48 48 66 48 51 35 36 36 48 │ │ │ │ │ +51 45 51 76 25 48 28 25 51 45 28 40 51 40 51 45 9[93 │ │ │ │ │ +2[66 3[62 71 2[57 2[33 3[62 2[64 4[71 1[25 5[45 45 45 │ │ │ │ │ +45 45 2[25 30 25 2[35 35 25 24[76 1[51 53 11[{}51 90.9091 │ │ │ │ │ +/CMR10 rf /Fl 133[103 123 123 3[90 1[95 2[116 129 194 │ │ │ │ │ +65 2[65 3[106 129 103 129 113 13[129 9[87 2[146 11[65 │ │ │ │ │ +58[{}19 206.559 /CMBX12 rf /Fm 134[106 11[106 9[106 106 │ │ │ │ │ +106 13[106 12[106 70[{}7 206.559 /CMTT12 rf /Fn 139[75 │ │ │ │ │ +1[79 1[108 7[108 2[88 3[94 29[140 17[97 49[{}8 172.188 │ │ │ │ │ +/CMBX12 rf end │ │ │ │ │ %%EndProlog │ │ │ │ │ %%BeginSetup │ │ │ │ │ %%Feature: *Resolution 600dpi │ │ │ │ │ TeXDict begin │ │ │ │ │ %%BeginPaperSize: a4 │ │ │ │ │ /setpagedevice where │ │ │ │ │ { pop << /PageSize [595 842] >> setpagedevice } │ │ │ │ │ @@ -4046,17 +4037,17 @@ │ │ │ │ │ (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 1131 4 v │ │ │ │ │ -1313 w Fj(SymbFac)29 b Fc(:)40 b Fi(DRAFT)30 b Fc(Ma)m(y)i(17,)f(2024)p │ │ │ │ │ -2769 100 V 0 399 a Fb(1.2.1)112 b(Sym)m(b)s(olic)39 b(factorization)f │ │ │ │ │ +TeXDict begin 2 1 bop 0 100 a Fk(2)p 136 100 1124 4 v │ │ │ │ │ +1306 w Fj(SymbFac)29 b Fc(:)40 b Fi(DRAFT)30 b Fc(June)g(20,)h(2025)p │ │ │ │ │ +2776 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) │ │ │ │ │ @@ -4140,17 +4131,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 1131 4 v 1313 100 a Fj(SymbFac)28 │ │ │ │ │ -b Fc(:)41 b Fi(DRAFT)121 b Fc(Ma)m(y)31 b(17,)h(2024)p │ │ │ │ │ -2722 100 V 1131 w Fk(3)337 399 y Fa(\210)45 b Fk(The)30 │ │ │ │ │ +TeXDict begin 3 2 bop 91 100 1124 4 v 1306 100 a Fj(SymbFac)28 │ │ │ │ │ +b Fc(:)41 b Fi(DRAFT)121 b Fc(June)29 b(20,)j(2025)p │ │ │ │ │ +2729 100 V 1124 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 │ │ │ │ │ @@ -4231,17 +4222,17 @@ │ │ │ │ │ (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 1131 4 v │ │ │ │ │ -1313 w Fj(SymbFac)29 b Fc(:)40 b Fi(DRAFT)30 b Fc(Ma)m(y)i(17,)f(2024)p │ │ │ │ │ -2769 100 V 337 399 a Fa(\210)45 b Fk(The)24 b Fj(outETreeFile)d │ │ │ │ │ +TeXDict begin 4 3 bop 0 100 a Fk(4)p 136 100 1124 4 v │ │ │ │ │ +1306 w Fj(SymbFac)29 b Fc(:)40 b Fi(DRAFT)30 b Fc(June)g(20,)h(2025)p │ │ │ │ │ +2776 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 │ │ │ │ │ ├── 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 May 17, 2024 │ │ │ │ │ │ + 2 SymbFac : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 3 │ │ │ │ │ │ + SymbFac : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 4 SymbFac : DRAFT June 20, 2025 │ │ │ │ │ │ • 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 2024.05.17:2218 │ │ │ │ │ +%DVIPSSource: TeX output 2025.06.20:0450 │ │ │ │ │ %%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 │ │ │ │ │ @@ -2227,22 +2227,21 @@ │ │ │ │ │ /UnderlinePosition -100 def │ │ │ │ │ /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 49 /one put │ │ │ │ │ dup 50 /two put │ │ │ │ │ -dup 52 /four put │ │ │ │ │ -dup 55 /seven put │ │ │ │ │ +dup 53 /five put │ │ │ │ │ dup 58 /colon put │ │ │ │ │ -dup 77 /M put │ │ │ │ │ -dup 97 /a put │ │ │ │ │ -dup 121 /y put │ │ │ │ │ +dup 74 /J put │ │ │ │ │ +dup 101 /e put │ │ │ │ │ +dup 110 /n put │ │ │ │ │ +dup 117 /u put │ │ │ │ │ readonly def │ │ │ │ │ currentdict end │ │ │ │ │ currentfile eexec │ │ │ │ │ D9D66F633B846AB284BCF8B0411B772DE5CE32340DC6F28AF40857E4451976E7 │ │ │ │ │ 5182433CF9F333A38BD841C0D4E68BF9E012EB32A8FFB76B5816306B5EDF7C99 │ │ │ │ │ 8B3A16D9B4BC056662E32C7CD0123DFAEB734C7532E64BBFBF5A60336E646716 │ │ │ │ │ EFB852C877F440D329172C71F1E5D59CE9473C26B8AEF7AD68EF0727B6EC2E0C │ │ │ │ │ @@ -2423,72 +2422,64 @@ │ │ │ │ │ 7CA1534C4D5B05FC33F83790ECFD7641DF3FB94289E2A1F6E7D29AB1228A867A │ │ │ │ │ 6E1EF0E9C6F899B491DC18401C2C0A05FFFED46A72C245F7529B8EA55A038082 │ │ │ │ │ 8512307217D2A233C37004085BA3AEE379269F9FA7D0ADB4B19A95CC2AFE686E │ │ │ │ │ 55D88E47257C1FE6F235FEA295910569FE6DD5995512562359CC821E85A6C7A5 │ │ │ │ │ 79B470A9E340A6985189FF8B6AF914A6B0ECF93F47903221F95DE894A8F05B05 │ │ │ │ │ B7D99CD533EC5F931B18E6B39BECF67FA2D6DD1AEC76772B068BE06335A94C05 │ │ │ │ │ 7A4DDEE77B66101DA855C17AC312600370B34E31F5EC3A01300A8EB60B4C9767 │ │ │ │ │ -1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004B9BA1CC │ │ │ │ │ -580D3C6BDA4DC1B80B4365F1C80512453FC5316EC2D928FB731C3D6403E3C18B │ │ │ │ │ -E8424D644DF5E9A2134229C5C91CA68DB8E85BA2BB40F538F585DA6FA4037718 │ │ │ │ │ -B8053EBBA1E765346BCD5BDAA6C38115D31611D8A87A2238C145F2DA2F92E4DF │ │ │ │ │ -3987BD9C4D2A3D460E8941A68B125BCD9EE4F9FD262C4C8A71F47A2C81975635 │ │ │ │ │ -F1B981C274C53FA2ACCDE4C9D0A7C62D6C1EFF91CFC6712CA6A9F333C9564FCB │ │ │ │ │ -2A70F0AD715A79B10A08AB069E2A3C93BC0AED19D0CA10134B8DDDE8AF548DB2 │ │ │ │ │ -3A4AAA9C29682CF135BB767DAA16169A127EB50A7EECEB6480CF56A7D0F8AC56 │ │ │ │ │ -4A5090B3D75A790372886AF568D94C8165975A05BFBFDF1FFBA45F70700BB9E0 │ │ │ │ │ -57F3249EF9E9C8AD9CBCF6E4FD592DC4CDD2CC7C0BC3130C1059096C657BE453 │ │ │ │ │ -A2CBACE93420210E27AF56CA229BD6D982FB68B3FDC6D44478B922C4231C47EE │ │ │ │ │ -E500232F6C11D92DEB955F66DF52B92B22E7352790CC2DCBAC53965D57AC2920 │ │ │ │ │ -68B7D520DE25047146EFEB06B9AD4E2A94243C7E5239F0BC2FC312B16051D52C │ │ │ │ │ -0B92C217B6B42997321AE4F8BB066754B7AA3F15069EF59224E8A442CE471AA7 │ │ │ │ │ -E8049A3DD9EDA09CCEE4998998661CF7DB35E952F6C65DAEB3013951C59F3E09 │ │ │ │ │ -157F313B0237876E1C0190F0473819570B8C0205AADF05D787CC00979CFB327A │ │ │ │ │ -289382B22DDA6F12804ED0ED5B179E36A995A2A59E1B66E75130DBE9109C813B │ │ │ │ │ -94403E0DEA8314A1E9DB474D7FA83C0BAFD08033E6A6215844C1D26BE15F1251 │ │ │ │ │ -A1605E8DF9A9C601ED37379530BC1C82BE5463C6C711C5652BFD6262485AA9CA │ │ │ │ │ -B8C4A117593001D08D980041E2A83C190DCE8E6CD3D334E5CC19FC05DB30F7F7 │ │ │ │ │ -24A305C4DBB31F0651392B99D44B4302333BDF7E326FD256DD75D309C6E73F85 │ │ │ │ │ -FA71B35FD1F9BEFF4C7A1076362EEB0A85492933B6006086A7B8C1928CF2D1EE │ │ │ │ │ -FD4344409257BB802C117E739960821CD3C88BFBA5669FF16F610AD638AF3677 │ │ │ │ │ -8674C985E6767253ED5769F71BEA5E9BB02A751F9E62EE2B18AC19D975FDEAE9 │ │ │ │ │ -8B8822367FF177A7E850766DE99ED3366D46464612926430012212A90F8E85F4 │ │ │ │ │ -4760B40D5B86B90819EE410382C23E86DCAF4F0FF5DFEB2C285965F4DCF2FB2B │ │ │ │ │ -457C0A0427A8D4ADA514E9DACD0F9367E1DA225DB21DA4DDAE33F2B529686D92 │ │ │ │ │ -AC085B345565F9DFFA012FD494DBB2E0B44A0787B2B72DC8D25399DAAE8864B7 │ │ │ │ │ -E84AA99DAFCEAF18F8B41882720316450F1B1CA48B418C9736E5CE4AFF996111 │ │ │ │ │ -5F7FE80958B6A3498508E9693CB134402D92E30D4C2939070D4647E13682290E │ │ │ │ │ -1D0820A3FCA7147157D09D1A40771F214EAE7DD743EA26839E535CA186C05CB8 │ │ │ │ │ -4874988AA1104D85AF0220FE7224344FF624E794BD2454E1C0AC971522FBECBA │ │ │ │ │ -B2497F25CD621B77EC5160973EF5ECC39C183DC051B0DFCB090194A2525BD96E │ │ │ │ │ -28593FDA80D8D259F039416D5F9AF0AD3C9A105B49DAF6E681921E369B7666C6 │ │ │ │ │ -2B73DB37447B00AE96317C2F1C44FB6E6EFD740BAB20FA03A8CE018EC8415582 │ │ │ │ │ -FB06E88A2971E3A480FB1EB4FE93CC7E5179721CAABEE88742B13CF0405F49F4 │ │ │ │ │ -945E587668C821D8C06D6847B6DF84CAFFCD4628670D551FC5F7236875BE1207 │ │ │ │ │ -634BA7F70A19B658FAE7D86F6D00ED28FBF29CC585DEE279325EEF8B0CCB6149 │ │ │ │ │ -E46E638C73D75148F18A636DBC2DD96ED34F68A5A09A3700B1EA34B2D142807C │ │ │ │ │ -F8709D81180783548EAE6F457BF968602076A1069163E3C15BBCEF659C6CF2E6 │ │ │ │ │ -0BB01BDC8E503802CC7969A5B8477E9788C5249B23B19669F5075E089738E49A │ │ │ │ │ -8671D7C1B1B47652F3D78BF2FF74EDB44BA5B092E8D5B85001E97F69D54AEEFC │ │ │ │ │ -88FC3CA1B0D5BAC39263B371005BCFA19AD197A31CC34D0BD55C2CA18C60C485 │ │ │ │ │ -5993F736EF1DD2C5D2B4D50B3D498861B4DF5E7AFF614BBCA4C2E6BECC0DCEF5 │ │ │ │ │ -95F0D686188014C530D8E37650CDCAE721B4AFB0F178BC744BDDDED45DAB7FEB │ │ │ │ │ -A10B975E26099E3DC61116D6BF554574F948895B88EEFE03DCC5351190836AD4 │ │ │ │ │ -EBC1AC55C6D099A8E7B0A372D290C481F44FA464B9C11A0BC991CB045E0AAAC4 │ │ │ │ │ -5C73CA43A4F17D1ADDD33D1B917FF95BFF411C8409F41553B1BC97DE47E3A1F4 │ │ │ │ │ -A5C1D1B7B1BF7E2507AC53956C141411F4F657E37981996DD7BB7ADB2CB6AE01 │ │ │ │ │ -73D0876B8F896F626D5022FE53BA34D5668BD698BE8D5CCAD083CBCEF440BE6A │ │ │ │ │ -8090EB1CDEE5F99C8988650BD4E539B357C31C597D8A9104A9D5967D4E906CAD │ │ │ │ │ -2A65575A884B1C5F6CC509E742FA9DDD66494F219178161AF72C50848E226A95 │ │ │ │ │ -A8C247FF9FF0BABD073021271B5C0692F9BE220071DAB09E5A026629371EE3C4 │ │ │ │ │ -A6E4FA94625D87A5B66EF077ED54C72B1052AEAA9637B30C76EF8EB04AD5F476 │ │ │ │ │ -D15F1C93C0BC6E0F67B366097BBED03FE82C040F9EF02866159B46854E11D44F │ │ │ │ │ -54AE6748A7E61B993A4EECD3B8BE3B5897A66BBCDFE24F65BC2AD5AB49048CF1 │ │ │ │ │ -647203823F84DF5CB483096F9D96AEE3A2855E479B72A14A67C633CE99C101CF │ │ │ │ │ -EFAE939BF9B02E710D │ │ │ │ │ +1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004ACD1870 │ │ │ │ │ +A5EA947858F5795870BFE1343AD803FB854BF8F5A4E794E8EC57BE41DB5B8734 │ │ │ │ │ +13E47950F29A81EA0C81EA798863883D7F41F78325CA190CBBFFE822AE494550 │ │ │ │ │ +4BE83703071FC9512D128927AF3F63CEF8F86ABE1E15D7B4DDD39576E7DFF45E │ │ │ │ │ +3CB4115AAB1830DE8647B915DB4BEBEB5235C281E098B899BAB951D8D5798F01 │ │ │ │ │ +7F7C47336D31438E5126738AFEAB29E9A7CBE06DE4DD604477B542D2620DFD58 │ │ │ │ │ +28FE34238572F23C5A8EB7ACEE1E154DA13FC1A5AA67A3BA8C5CDFB2B80312C9 │ │ │ │ │ +BC9FAE56D08DDFA9498E6EF0D0F6BD18B3923E0B670B0740528BC843610736CB │ │ │ │ │ +80228C105C2F72C3C22D610C3D8C268DEEA2AEEE3221E198E79FE2966487360C │ │ │ │ │ +84AE08AC326F48B21447652121B1EB68AF856055EEA65B6B625BF622CBFC2D1C │ │ │ │ │ +EF943CC4CAF2C715782C9EF9A9BA4689BFC6B6A82F8D55795BE8111E2C7DE520 │ │ │ │ │ +367362304B6A48186C842033E715A46265A352472F4F7313248EBCD26BEA97E7 │ │ │ │ │ +B814A61D4B7ADCB5C5F21AA34E0C1269E8426DBFB511DE6E26B960456C8F8520 │ │ │ │ │ +5F0DD382289A62AF0B935EDB5B2394538C5F0EE72962D2F98F3C38CD7C027B9F │ │ │ │ │ +E230E67E40FEFBDED06B3423C9DFD669E6B5BC913E0FF75786A64A6C11D4FE89 │ │ │ │ │ +1B918DC0E953C52CFD153063CD0D2A78B43F8712243845E6F2CBA1DB610F403D │ │ │ │ │ +A98D06D95FF44C7AC029092B666A8B0DCEA95B34F5ACC10E8611BADE6A24469C │ │ │ │ │ +0C01D95BFB445FA22CD38D033E4D24E006BB9D54EE41EF7AD5AC9C299721F61A │ │ │ │ │ +F01B6EDCDF428BD9195A13C5B1027358F8A203F828A1DD9622243B2D76C6F1BA │ │ │ │ │ +9F2D7E9D4879FC668ABC750CD25415DC6CCF2257C28F78D3F9BE499CC0FF2F80 │ │ │ │ │ +2C2CD1DEFABD6668FCA76E1D629A344333E33DA24B86D2E9F8F5EE1C29974640 │ │ │ │ │ +C3E78E999BAB313400041DADDDFDBFFCC419F129A84F4D412B79E8BE4511CA00 │ │ │ │ │ +F92A4F3CDD2E51345D3965C104F06B6503445DC20224CB7606A9D7D5F9EE45E6 │ │ │ │ │ +1B2963DA96AA2AB1BA5BE29656E666E4D0E122DE58EEA68E04ED76438DA03E65 │ │ │ │ │ +B80055A86B7B2A26BAE6BBB8835E17F9696E9B3CD34571BA75C76D4D2CCC48F1 │ │ │ │ │ +7534C1EF9127E374D65D05B8072E08D6C72A0B4A35EA0DD717743C66D105CCD8 │ │ │ │ │ +7355F13E9C38C1A4351624E689ED7909100942FA0474842EE44DEC3279E1A1CD │ │ │ │ │ +8064666EB845CA7C3E906B67C0BF96A28D514DB2E4A1E4AF287350B03762A2CF │ │ │ │ │ +13B18AC3F5D2F3B74A1D50267C03EFB74B888E1D24ABEEA4A885F4D0BF14C0D8 │ │ │ │ │ +289AC79D6D98E2A2C831672FB1F3457564CD161ADC3AF610D88201AB5B0C10CB │ │ │ │ │ +5ECCC2D5C4AF39C8CB3044BF9EC791BA45D29C2B51EA0483D19822C264CE6FA3 │ │ │ │ │ +5C97F2DF5A78CB93528E99B9ED7CB121C83130C129B849B52A36EBD88AF19DD3 │ │ │ │ │ +C5CABE831027388EF86BD5CBD90AAAC089775938A321C44D4DDA67A51312D8AB │ │ │ │ │ +C509DDBE7044A107AB2BE9C4C9556F85C529B174A7778B489BF28EC07A834542 │ │ │ │ │ +8B31F2925C21FB2096877711F998763D5A8495002B8E080AF8DBB1B3106EDDBA │ │ │ │ │ +35121D52E0846A7AF3ABEDF87BDE4FA665673A9B80CA538B98F873947AA17EF4 │ │ │ │ │ +9BB182917E9D79BC7EC681E93710D6A1D6B0E4A7FA9452FC1C431808174F3AB7 │ │ │ │ │ +F3914FBC86CB34E8583457243C3C7BE4BC166C7397689BC6FFB82EA2967E88EE │ │ │ │ │ +464F96EDA144DE2B64401B8E577ABCA2D826FE0B92E21FFAE3E81EBB6B6EB36E │ │ │ │ │ +9B1A8FE3884CA398C03135FD49D51724FC1268E9482E41FAEA2FC6C809006B8F │ │ │ │ │ +5D4F9E038450AD3A6041C16FD1C7E5FC80C0E033CE57E64863E014531D94DF1E │ │ │ │ │ +31D7D038AFCB60715AA73C1E96F113A24C5AF35BBEB61C4D079ED034ED83AA4A │ │ │ │ │ +E12448E618330463304788BCF40561CD63167B3BF144F408E2B89E60B8BA13EF │ │ │ │ │ +3B57D286FD23D4FA8BAEFF98DC1188B1982956CC1DCAEFC7D949B7B4E3BE8F8A │ │ │ │ │ +BFE2C9D938DD13EFEE7123576608D9396F260907DA98AE2D3DD5822306CBC8A6 │ │ │ │ │ +B083C697DDA3C62EE7879436A9FD8EE0034B105105B3F122F893EA2126EBE8A9 │ │ │ │ │ +5CBF2BD248DD9FBEF0040C25797BD13B69A8C9F0D4E4F935C61ED30487CCDB1A │ │ │ │ │ +0339006E78EE1755929D2412776EC7DB1F666DBDD28EA8AC7397F809C7F38A41 │ │ │ │ │ +5B3BF6C75F4F35C90141EB08377AF452CF840FEA938805F9D14E02DC29215B4E │ │ │ │ │ +F1EB │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ @@ -4933,16 +4924,16 @@ │ │ │ │ │ @start /Fa 173[73 13[75 17[50 50 50 48[{}5 90.9091 /CMCSC10 │ │ │ │ │ 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 23[45 19[83 │ │ │ │ │ -18[25 2[45 2[45 1[45 45 45 3[25 44[{}10 90.9091 /CMSL10 │ │ │ │ │ +16[62 84[{}3 119.552 /CMTT12 rf /Fg 138[51 6[51 8[40 │ │ │ │ │ +26[47 15[25 4[45 2[45 1[45 3[25 44[{}9 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 │ │ │ │ │ @@ -5065,17 +5056,17 @@ │ │ │ │ │ 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 1203 4 v │ │ │ │ │ -1385 w Fm(Tree)29 b Fg(:)41 b Fl(DRAFT)30 b Fg(Ma)m(y)h(17,)h(2024)p │ │ │ │ │ -2698 100 V 0 399 a Fj(1.2)135 b(Protot)l(yp)t(es)46 b(and)f │ │ │ │ │ +TeXDict begin 2 1 bop 0 100 a Fn(2)p 136 100 1196 4 v │ │ │ │ │ +1378 w Fm(Tree)29 b Fg(:)41 b Fl(DRAFT)30 b Fg(June)f(20,)j(2025)p │ │ │ │ │ +2704 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 │ │ │ │ │ @@ -5124,17 +5115,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 1203 4 v 1384 100 a Fm(Tree)29 │ │ │ │ │ -b Fg(:)41 b Fl(DRAFT)121 b Fg(Ma)m(y)32 b(17,)f(2024)p │ │ │ │ │ -2650 100 V 1203 w Fn(3)111 399 y(4.)46 b Fm(int)h(*)h(Tree_fch)d(\()j │ │ │ │ │ +TeXDict begin 3 2 bop 91 100 1196 4 v 1377 100 a Fm(Tree)30 │ │ │ │ │ +b Fg(:)40 b Fl(DRAFT)121 b Fg(June)30 b(20,)h(2025)p │ │ │ │ │ +2657 100 V 1196 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) │ │ │ │ │ @@ -5192,17 +5183,17 @@ │ │ │ │ │ 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 1203 4 v │ │ │ │ │ -1385 w Fm(Tree)29 b Fg(:)41 b Fl(DRAFT)30 b Fg(Ma)m(y)h(17,)h(2024)p │ │ │ │ │ -2698 100 V 111 399 a Fn(5.)46 b Fm(void)h(Tree_setFchSibRoot)c(\()k │ │ │ │ │ +TeXDict begin 4 3 bop 0 100 a Fn(4)p 136 100 1196 4 v │ │ │ │ │ +1378 w Fm(Tree)29 b Fg(:)41 b Fl(DRAFT)30 b Fg(June)f(20,)j(2025)p │ │ │ │ │ +2704 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 │ │ │ │ │ @@ -5257,17 +5248,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 1203 4 v 1384 100 a Fm(Tree)29 │ │ │ │ │ -b Fg(:)41 b Fl(DRAFT)121 b Fg(Ma)m(y)32 b(17,)f(2024)p │ │ │ │ │ -2650 100 V 1203 w Fn(5)111 399 y(6.)46 b Fm(int)h(Tree_nleaves)e(\()i │ │ │ │ │ +TeXDict begin 5 4 bop 91 100 1196 4 v 1377 100 a Fm(Tree)30 │ │ │ │ │ +b Fg(:)40 b Fl(DRAFT)121 b Fg(June)30 b(20,)h(2025)p │ │ │ │ │ +2657 100 V 1196 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 │ │ │ │ │ @@ -5316,17 +5307,17 @@ │ │ │ │ │ 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 1203 4 v │ │ │ │ │ -1385 w Fm(Tree)29 b Fg(:)41 b Fl(DRAFT)30 b Fg(Ma)m(y)h(17,)h(2024)p │ │ │ │ │ -2698 100 V 0 399 a Fe(1.2.5)112 b(Metrics)38 b(metho)s(ds)0 │ │ │ │ │ +TeXDict begin 6 5 bop 0 100 a Fn(6)p 136 100 1196 4 v │ │ │ │ │ +1378 w Fm(Tree)29 b Fg(:)41 b Fl(DRAFT)30 b Fg(June)f(20,)j(2025)p │ │ │ │ │ +2704 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 │ │ │ │ │ @@ -5385,17 +5376,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 1203 4 v 1384 100 a Fm(Tree)29 │ │ │ │ │ -b Fg(:)41 b Fl(DRAFT)121 b Fg(Ma)m(y)32 b(17,)f(2024)p │ │ │ │ │ -2650 100 V 1203 w Fn(7)0 399 y Fe(1.2.6)112 b(Compression)39 │ │ │ │ │ +TeXDict begin 7 6 bop 91 100 1196 4 v 1377 100 a Fm(Tree)30 │ │ │ │ │ +b Fg(:)40 b Fl(DRAFT)121 b Fg(June)30 b(20,)h(2025)p │ │ │ │ │ +2657 100 V 1196 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 │ │ │ │ │ @@ -5471,17 +5462,17 @@ │ │ │ │ │ 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 1203 4 v │ │ │ │ │ -1385 w Fm(Tree)29 b Fg(:)41 b Fl(DRAFT)30 b Fg(Ma)m(y)h(17,)h(2024)p │ │ │ │ │ -2698 100 V 227 399 a Fl(Err)-5 b(or)34 b(che)-5 b(cking:)40 │ │ │ │ │ +TeXDict begin 8 7 bop 0 100 a Fn(8)p 136 100 1196 4 v │ │ │ │ │ +1378 w Fm(Tree)29 b Fg(:)41 b Fl(DRAFT)30 b Fg(June)f(20,)j(2025)p │ │ │ │ │ +2704 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 │ │ │ │ │ @@ -5542,17 +5533,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 1203 4 v 1384 100 a Fm(Tree)29 │ │ │ │ │ -b Fg(:)41 b Fl(DRAFT)121 b Fg(Ma)m(y)32 b(17,)f(2024)p │ │ │ │ │ -2650 100 V 1203 w Fn(9)1230 399 y Fm(double)46 b(frame[],)f(double)h │ │ │ │ │ +TeXDict begin 9 8 bop 91 100 1196 4 v 1377 100 a Fm(Tree)30 │ │ │ │ │ +b Fg(:)40 b Fl(DRAFT)121 b Fg(June)30 b(20,)h(2025)p │ │ │ │ │ +2657 100 V 1196 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 │ │ │ │ │ @@ -5625,17 +5616,17 @@ │ │ │ │ │ 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 1180 4 │ │ │ │ │ -v 1362 w Fm(Tree)30 b Fg(:)40 b Fl(DRAFT)31 b Fg(Ma)m(y)g(17,)h(2024)p │ │ │ │ │ -2720 100 V 111 399 a Fn(3.)46 b Fm(int)h(Tree_readFromBinaryFile)42 │ │ │ │ │ +TeXDict begin 10 9 bop 0 100 a Fn(10)p 182 100 1173 4 │ │ │ │ │ +v 1356 w Fm(Tree)29 b Fg(:)40 b Fl(DRAFT)31 b Fg(June)e(20,)i(2025)p │ │ │ │ │ +2727 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 │ │ │ │ │ @@ -5703,17 +5694,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 1180 4 v 1362 100 a Fm(Tree)29 │ │ │ │ │ -b Fg(:)40 b Fl(DRAFT)122 b Fg(Ma)m(y)31 b(17,)h(2024)p │ │ │ │ │ -2628 100 V 1180 w Fn(11)337 399 y Fi(\210)45 b Fn(The)33 │ │ │ │ │ +TeXDict begin 11 10 bop 91 100 1173 4 v 1355 100 a Fm(Tree)29 │ │ │ │ │ +b Fg(:)40 b Fl(DRAFT)122 b Fg(June)29 b(20,)i(2025)p │ │ │ │ │ +2634 100 V 1173 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 │ │ │ │ │ @@ -5761,17 +5752,17 @@ │ │ │ │ │ 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 1180 │ │ │ │ │ -4 v 1362 w Fm(Tree)30 b Fg(:)40 b Fl(DRAFT)31 b Fg(Ma)m(y)g(17,)h(2024) │ │ │ │ │ -p 2720 100 V 0 571 a Fn(Figure)38 b(1.1:)56 b Fa(R2D100)p │ │ │ │ │ +TeXDict begin 12 11 bop 0 100 a Fn(12)p 182 100 1173 │ │ │ │ │ +4 v 1356 w Fm(Tree)29 b Fg(:)40 b Fl(DRAFT)31 b Fg(June)e(20,)i(2025)p │ │ │ │ │ +2727 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 │ │ │ │ │ ├── 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 May 17, 2024 │ │ │ │ │ │ + 2 Tree : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 3 │ │ │ │ │ │ + Tree : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 4 Tree : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 5 │ │ │ │ │ │ + Tree : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 6 Tree : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 7 │ │ │ │ │ │ + Tree : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 8 Tree : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 9 │ │ │ │ │ │ + Tree : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 10 Tree : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 11 │ │ │ │ │ │ + Tree : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 12 Tree : DRAFT June 20, 2025 │ │ │ │ │ │ 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 2024.05.17:2218 │ │ │ │ │ +%DVIPSSource: TeX output 2025.06.20:0450 │ │ │ │ │ %%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 │ │ │ │ │ @@ -3357,22 +3357,21 @@ │ │ │ │ │ /UnderlinePosition -100 def │ │ │ │ │ /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 49 /one put │ │ │ │ │ dup 50 /two put │ │ │ │ │ -dup 52 /four put │ │ │ │ │ -dup 55 /seven put │ │ │ │ │ +dup 53 /five put │ │ │ │ │ dup 58 /colon put │ │ │ │ │ -dup 77 /M put │ │ │ │ │ -dup 97 /a put │ │ │ │ │ -dup 121 /y put │ │ │ │ │ +dup 74 /J put │ │ │ │ │ +dup 101 /e put │ │ │ │ │ +dup 110 /n put │ │ │ │ │ +dup 117 /u put │ │ │ │ │ readonly def │ │ │ │ │ currentdict end │ │ │ │ │ currentfile eexec │ │ │ │ │ D9D66F633B846AB284BCF8B0411B772DE5CE32340DC6F28AF40857E4451976E7 │ │ │ │ │ 5182433CF9F333A38BD841C0D4E68BF9E012EB32A8FFB76B5816306B5EDF7C99 │ │ │ │ │ 8B3A16D9B4BC056662E32C7CD0123DFAEB734C7532E64BBFBF5A60336E646716 │ │ │ │ │ EFB852C877F440D329172C71F1E5D59CE9473C26B8AEF7AD68EF0727B6EC2E0C │ │ │ │ │ @@ -3553,72 +3552,64 @@ │ │ │ │ │ 7CA1534C4D5B05FC33F83790ECFD7641DF3FB94289E2A1F6E7D29AB1228A867A │ │ │ │ │ 6E1EF0E9C6F899B491DC18401C2C0A05FFFED46A72C245F7529B8EA55A038082 │ │ │ │ │ 8512307217D2A233C37004085BA3AEE379269F9FA7D0ADB4B19A95CC2AFE686E │ │ │ │ │ 55D88E47257C1FE6F235FEA295910569FE6DD5995512562359CC821E85A6C7A5 │ │ │ │ │ 79B470A9E340A6985189FF8B6AF914A6B0ECF93F47903221F95DE894A8F05B05 │ │ │ │ │ B7D99CD533EC5F931B18E6B39BECF67FA2D6DD1AEC76772B068BE06335A94C05 │ │ │ │ │ 7A4DDEE77B66101DA855C17AC312600370B34E31F5EC3A01300A8EB60B4C9767 │ │ │ │ │ -1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004B9BA1CC │ │ │ │ │ -580D3C6BDA4DC1B80B4365F1C80512453FC5316EC2D928FB731C3D6403E3C18B │ │ │ │ │ -E8424D644DF5E9A2134229C5C91CA68DB8E85BA2BB40F538F585DA6FA4037718 │ │ │ │ │ -B8053EBBA1E765346BCD5BDAA6C38115D31611D8A87A2238C145F2DA2F92E4DF │ │ │ │ │ -3987BD9C4D2A3D460E8941A68B125BCD9EE4F9FD262C4C8A71F47A2C81975635 │ │ │ │ │ -F1B981C274C53FA2ACCDE4C9D0A7C62D6C1EFF91CFC6712CA6A9F333C9564FCB │ │ │ │ │ -2A70F0AD715A79B10A08AB069E2A3C93BC0AED19D0CA10134B8DDDE8AF548DB2 │ │ │ │ │ -3A4AAA9C29682CF135BB767DAA16169A127EB50A7EECEB6480CF56A7D0F8AC56 │ │ │ │ │ -4A5090B3D75A790372886AF568D94C8165975A05BFBFDF1FFBA45F70700BB9E0 │ │ │ │ │ -57F3249EF9E9C8AD9CBCF6E4FD592DC4CDD2CC7C0BC3130C1059096C657BE453 │ │ │ │ │ -A2CBACE93420210E27AF56CA229BD6D982FB68B3FDC6D44478B922C4231C47EE │ │ │ │ │ -E500232F6C11D92DEB955F66DF52B92B22E7352790CC2DCBAC53965D57AC2920 │ │ │ │ │ -68B7D520DE25047146EFEB06B9AD4E2A94243C7E5239F0BC2FC312B16051D52C │ │ │ │ │ -0B92C217B6B42997321AE4F8BB066754B7AA3F15069EF59224E8A442CE471AA7 │ │ │ │ │ -E8049A3DD9EDA09CCEE4998998661CF7DB35E952F6C65DAEB3013951C59F3E09 │ │ │ │ │ -157F313B0237876E1C0190F0473819570B8C0205AADF05D787CC00979CFB327A │ │ │ │ │ -289382B22DDA6F12804ED0ED5B179E36A995A2A59E1B66E75130DBE9109C813B │ │ │ │ │ -94403E0DEA8314A1E9DB474D7FA83C0BAFD08033E6A6215844C1D26BE15F1251 │ │ │ │ │ -A1605E8DF9A9C601ED37379530BC1C82BE5463C6C711C5652BFD6262485AA9CA │ │ │ │ │ -B8C4A117593001D08D980041E2A83C190DCE8E6CD3D334E5CC19FC05DB30F7F7 │ │ │ │ │ -24A305C4DBB31F0651392B99D44B4302333BDF7E326FD256DD75D309C6E73F85 │ │ │ │ │ -FA71B35FD1F9BEFF4C7A1076362EEB0A85492933B6006086A7B8C1928CF2D1EE │ │ │ │ │ -FD4344409257BB802C117E739960821CD3C88BFBA5669FF16F610AD638AF3677 │ │ │ │ │ -8674C985E6767253ED5769F71BEA5E9BB02A751F9E62EE2B18AC19D975FDEAE9 │ │ │ │ │ -8B8822367FF177A7E850766DE99ED3366D46464612926430012212A90F8E85F4 │ │ │ │ │ -4760B40D5B86B90819EE410382C23E86DCAF4F0FF5DFEB2C285965F4DCF2FB2B │ │ │ │ │ -457C0A0427A8D4ADA514E9DACD0F9367E1DA225DB21DA4DDAE33F2B529686D92 │ │ │ │ │ -AC085B345565F9DFFA012FD494DBB2E0B44A0787B2B72DC8D25399DAAE8864B7 │ │ │ │ │ -E84AA99DAFCEAF18F8B41882720316450F1B1CA48B418C9736E5CE4AFF996111 │ │ │ │ │ -5F7FE80958B6A3498508E9693CB134402D92E30D4C2939070D4647E13682290E │ │ │ │ │ -1D0820A3FCA7147157D09D1A40771F214EAE7DD743EA26839E535CA186C05CB8 │ │ │ │ │ -4874988AA1104D85AF0220FE7224344FF624E794BD2454E1C0AC971522FBECBA │ │ │ │ │ -B2497F25CD621B77EC5160973EF5ECC39C183DC051B0DFCB090194A2525BD96E │ │ │ │ │ -28593FDA80D8D259F039416D5F9AF0AD3C9A105B49DAF6E681921E369B7666C6 │ │ │ │ │ -2B73DB37447B00AE96317C2F1C44FB6E6EFD740BAB20FA03A8CE018EC8415582 │ │ │ │ │ -FB06E88A2971E3A480FB1EB4FE93CC7E5179721CAABEE88742B13CF0405F49F4 │ │ │ │ │ -945E587668C821D8C06D6847B6DF84CAFFCD4628670D551FC5F7236875BE1207 │ │ │ │ │ -634BA7F70A19B658FAE7D86F6D00ED28FBF29CC585DEE279325EEF8B0CCB6149 │ │ │ │ │ -E46E638C73D75148F18A636DBC2DD96ED34F68A5A09A3700B1EA34B2D142807C │ │ │ │ │ -F8709D81180783548EAE6F457BF968602076A1069163E3C15BBCEF659C6CF2E6 │ │ │ │ │ -0BB01BDC8E503802CC7969A5B8477E9788C5249B23B19669F5075E089738E49A │ │ │ │ │ -8671D7C1B1B47652F3D78BF2FF74EDB44BA5B092E8D5B85001E97F69D54AEEFC │ │ │ │ │ -88FC3CA1B0D5BAC39263B371005BCFA19AD197A31CC34D0BD55C2CA18C60C485 │ │ │ │ │ -5993F736EF1DD2C5D2B4D50B3D498861B4DF5E7AFF614BBCA4C2E6BECC0DCEF5 │ │ │ │ │ -95F0D686188014C530D8E37650CDCAE721B4AFB0F178BC744BDDDED45DAB7FEB │ │ │ │ │ -A10B975E26099E3DC61116D6BF554574F948895B88EEFE03DCC5351190836AD4 │ │ │ │ │ -EBC1AC55C6D099A8E7B0A372D290C481F44FA464B9C11A0BC991CB045E0AAAC4 │ │ │ │ │ -5C73CA43A4F17D1ADDD33D1B917FF95BFF411C8409F41553B1BC97DE47E3A1F4 │ │ │ │ │ -A5C1D1B7B1BF7E2507AC53956C141411F4F657E37981996DD7BB7ADB2CB6AE01 │ │ │ │ │ -73D0876B8F896F626D5022FE53BA34D5668BD698BE8D5CCAD083CBCEF440BE6A │ │ │ │ │ -8090EB1CDEE5F99C8988650BD4E539B357C31C597D8A9104A9D5967D4E906CAD │ │ │ │ │ -2A65575A884B1C5F6CC509E742FA9DDD66494F219178161AF72C50848E226A95 │ │ │ │ │ -A8C247FF9FF0BABD073021271B5C0692F9BE220071DAB09E5A026629371EE3C4 │ │ │ │ │ -A6E4FA94625D87A5B66EF077ED54C72B1052AEAA9637B30C76EF8EB04AD5F476 │ │ │ │ │ -D15F1C93C0BC6E0F67B366097BBED03FE82C040F9EF02866159B46854E11D44F │ │ │ │ │ -54AE6748A7E61B993A4EECD3B8BE3B5897A66BBCDFE24F65BC2AD5AB49048CF1 │ │ │ │ │ -647203823F84DF5CB483096F9D96AEE3A2855E479B72A14A67C633CE99C101CF │ │ │ │ │ -EFAE939BF9B02E710D │ │ │ │ │ +1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004ACD1870 │ │ │ │ │ +A5EA947858F5795870BFE1343AD803FB854BF8F5A4E794E8EC57BE41DB5B8734 │ │ │ │ │ +13E47950F29A81EA0C81EA798863883D7F41F78325CA190CBBFFE822AE494550 │ │ │ │ │ +4BE83703071FC9512D128927AF3F63CEF8F86ABE1E15D7B4DDD39576E7DFF45E │ │ │ │ │ +3CB4115AAB1830DE8647B915DB4BEBEB5235C281E098B899BAB951D8D5798F01 │ │ │ │ │ +7F7C47336D31438E5126738AFEAB29E9A7CBE06DE4DD604477B542D2620DFD58 │ │ │ │ │ +28FE34238572F23C5A8EB7ACEE1E154DA13FC1A5AA67A3BA8C5CDFB2B80312C9 │ │ │ │ │ +BC9FAE56D08DDFA9498E6EF0D0F6BD18B3923E0B670B0740528BC843610736CB │ │ │ │ │ +80228C105C2F72C3C22D610C3D8C268DEEA2AEEE3221E198E79FE2966487360C │ │ │ │ │ +84AE08AC326F48B21447652121B1EB68AF856055EEA65B6B625BF622CBFC2D1C │ │ │ │ │ +EF943CC4CAF2C715782C9EF9A9BA4689BFC6B6A82F8D55795BE8111E2C7DE520 │ │ │ │ │ +367362304B6A48186C842033E715A46265A352472F4F7313248EBCD26BEA97E7 │ │ │ │ │ +B814A61D4B7ADCB5C5F21AA34E0C1269E8426DBFB511DE6E26B960456C8F8520 │ │ │ │ │ +5F0DD382289A62AF0B935EDB5B2394538C5F0EE72962D2F98F3C38CD7C027B9F │ │ │ │ │ +E230E67E40FEFBDED06B3423C9DFD669E6B5BC913E0FF75786A64A6C11D4FE89 │ │ │ │ │ +1B918DC0E953C52CFD153063CD0D2A78B43F8712243845E6F2CBA1DB610F403D │ │ │ │ │ +A98D06D95FF44C7AC029092B666A8B0DCEA95B34F5ACC10E8611BADE6A24469C │ │ │ │ │ +0C01D95BFB445FA22CD38D033E4D24E006BB9D54EE41EF7AD5AC9C299721F61A │ │ │ │ │ +F01B6EDCDF428BD9195A13C5B1027358F8A203F828A1DD9622243B2D76C6F1BA │ │ │ │ │ +9F2D7E9D4879FC668ABC750CD25415DC6CCF2257C28F78D3F9BE499CC0FF2F80 │ │ │ │ │ +2C2CD1DEFABD6668FCA76E1D629A344333E33DA24B86D2E9F8F5EE1C29974640 │ │ │ │ │ +C3E78E999BAB313400041DADDDFDBFFCC419F129A84F4D412B79E8BE4511CA00 │ │ │ │ │ +F92A4F3CDD2E51345D3965C104F06B6503445DC20224CB7606A9D7D5F9EE45E6 │ │ │ │ │ +1B2963DA96AA2AB1BA5BE29656E666E4D0E122DE58EEA68E04ED76438DA03E65 │ │ │ │ │ +B80055A86B7B2A26BAE6BBB8835E17F9696E9B3CD34571BA75C76D4D2CCC48F1 │ │ │ │ │ +7534C1EF9127E374D65D05B8072E08D6C72A0B4A35EA0DD717743C66D105CCD8 │ │ │ │ │ +7355F13E9C38C1A4351624E689ED7909100942FA0474842EE44DEC3279E1A1CD │ │ │ │ │ +8064666EB845CA7C3E906B67C0BF96A28D514DB2E4A1E4AF287350B03762A2CF │ │ │ │ │ +13B18AC3F5D2F3B74A1D50267C03EFB74B888E1D24ABEEA4A885F4D0BF14C0D8 │ │ │ │ │ +289AC79D6D98E2A2C831672FB1F3457564CD161ADC3AF610D88201AB5B0C10CB │ │ │ │ │ +5ECCC2D5C4AF39C8CB3044BF9EC791BA45D29C2B51EA0483D19822C264CE6FA3 │ │ │ │ │ +5C97F2DF5A78CB93528E99B9ED7CB121C83130C129B849B52A36EBD88AF19DD3 │ │ │ │ │ +C5CABE831027388EF86BD5CBD90AAAC089775938A321C44D4DDA67A51312D8AB │ │ │ │ │ +C509DDBE7044A107AB2BE9C4C9556F85C529B174A7778B489BF28EC07A834542 │ │ │ │ │ +8B31F2925C21FB2096877711F998763D5A8495002B8E080AF8DBB1B3106EDDBA │ │ │ │ │ +35121D52E0846A7AF3ABEDF87BDE4FA665673A9B80CA538B98F873947AA17EF4 │ │ │ │ │ +9BB182917E9D79BC7EC681E93710D6A1D6B0E4A7FA9452FC1C431808174F3AB7 │ │ │ │ │ +F3914FBC86CB34E8583457243C3C7BE4BC166C7397689BC6FFB82EA2967E88EE │ │ │ │ │ +464F96EDA144DE2B64401B8E577ABCA2D826FE0B92E21FFAE3E81EBB6B6EB36E │ │ │ │ │ +9B1A8FE3884CA398C03135FD49D51724FC1268E9482E41FAEA2FC6C809006B8F │ │ │ │ │ +5D4F9E038450AD3A6041C16FD1C7E5FC80C0E033CE57E64863E014531D94DF1E │ │ │ │ │ +31D7D038AFCB60715AA73C1E96F113A24C5AF35BBEB61C4D079ED034ED83AA4A │ │ │ │ │ +E12448E618330463304788BCF40561CD63167B3BF144F408E2B89E60B8BA13EF │ │ │ │ │ +3B57D286FD23D4FA8BAEFF98DC1188B1982956CC1DCAEFC7D949B7B4E3BE8F8A │ │ │ │ │ +BFE2C9D938DD13EFEE7123576608D9396F260907DA98AE2D3DD5822306CBC8A6 │ │ │ │ │ +B083C697DDA3C62EE7879436A9FD8EE0034B105105B3F122F893EA2126EBE8A9 │ │ │ │ │ +5CBF2BD248DD9FBEF0040C25797BD13B69A8C9F0D4E4F935C61ED30487CCDB1A │ │ │ │ │ +0339006E78EE1755929D2412776EC7DB1F666DBDD28EA8AC7397F809C7F38A41 │ │ │ │ │ +5B3BF6C75F4F35C90141EB08377AF452CF840FEA938805F9D14E02DC29215B4E │ │ │ │ │ +F1EB │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ @@ -5484,16 +5475,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 23[45 19[83 18[25 2[45 2[45 1[45 45 45 3[25 │ │ │ │ │ -44[{}10 90.9091 /CMSL10 rf │ │ │ │ │ +/Fl 138[51 6[51 8[40 26[47 15[25 4[45 2[45 1[45 3[25 │ │ │ │ │ +44[{}9 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 │ │ │ │ │ @@ -5592,33 +5583,33 @@ │ │ │ │ │ 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 1084 4 v │ │ │ │ │ -1265 w Fp(Utilities)28 b Fl(:)41 b Fk(DRAFT)30 b Fl(Ma)m(y)i(17,)f │ │ │ │ │ -(2024)p 2817 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 │ │ │ │ │ +TeXDict begin 2 1 bop 0 100 a Fq(2)p 136 100 1077 4 v │ │ │ │ │ +1258 w Fp(Utilities)28 b Fl(:)41 b Fk(DRAFT)30 b Fl(June)g(20,)h(2025)p │ │ │ │ │ +2824 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 │ │ │ │ │ @@ -5658,17 +5649,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 1084 4 v 1265 100 a Fp(Utilities)28 │ │ │ │ │ -b Fl(:)40 b Fk(DRAFT)122 b Fl(Ma)m(y)31 b(17,)h(2024)p │ │ │ │ │ -2770 100 V 1084 w Fq(3)111 399 y(2.)46 b Fp(double)g(*)i(DVinit2)e(\()h │ │ │ │ │ +TeXDict begin 3 2 bop 91 100 1077 4 v 1258 100 a Fp(Utilities)28 │ │ │ │ │ +b Fl(:)41 b Fk(DRAFT)121 b Fl(June)29 b(20,)j(2025)p │ │ │ │ │ +2777 100 V 1077 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 │ │ │ │ │ @@ -5720,18 +5711,18 @@ │ │ │ │ │ (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 1084 4 v │ │ │ │ │ -1265 w Fp(Utilities)28 b Fl(:)41 b Fk(DRAFT)30 b Fl(Ma)m(y)i(17,)f │ │ │ │ │ -(2024)p 2817 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 │ │ │ │ │ +TeXDict begin 4 3 bop 0 100 a Fq(4)p 136 100 1077 4 v │ │ │ │ │ +1258 w Fp(Utilities)28 b Fl(:)41 b Fk(DRAFT)30 b Fl(June)g(20,)h(2025)p │ │ │ │ │ +2824 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 │ │ │ │ │ @@ -5764,17 +5755,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 1084 4 v 1265 100 a Fp(Utilities)28 │ │ │ │ │ -b Fl(:)40 b Fk(DRAFT)122 b Fl(Ma)m(y)31 b(17,)h(2024)p │ │ │ │ │ -2770 100 V 1084 w Fq(5)66 399 y(19.)46 b Fp(void)h(DVcompress)e(\()i │ │ │ │ │ +TeXDict begin 5 4 bop 91 100 1077 4 v 1258 100 a Fp(Utilities)28 │ │ │ │ │ +b Fl(:)41 b Fk(DRAFT)121 b Fl(June)29 b(20,)j(2025)p │ │ │ │ │ +2777 100 V 1077 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 │ │ │ │ │ @@ -5864,18 +5855,18 @@ │ │ │ │ │ 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 1084 4 v │ │ │ │ │ -1265 w Fp(Utilities)28 b Fl(:)41 b Fk(DRAFT)30 b Fl(Ma)m(y)i(17,)f │ │ │ │ │ -(2024)p 2817 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 │ │ │ │ │ +TeXDict begin 6 5 bop 0 100 a Fq(6)p 136 100 1077 4 v │ │ │ │ │ +1258 w Fp(Utilities)28 b Fl(:)41 b Fk(DRAFT)30 b Fl(June)g(20,)h(2025)p │ │ │ │ │ +2824 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 │ │ │ │ │ @@ -5954,17 +5945,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 1084 4 v 1265 100 a Fp(Utilities)28 │ │ │ │ │ -b Fl(:)40 b Fk(DRAFT)122 b Fl(Ma)m(y)31 b(17,)h(2024)p │ │ │ │ │ -2770 100 V 1084 w Fq(7)66 399 y(31.)46 b Fp(int)h(DVdoti)f(\()i(int)f │ │ │ │ │ +TeXDict begin 7 6 bop 91 100 1077 4 v 1258 100 a Fp(Utilities)28 │ │ │ │ │ +b Fl(:)41 b Fk(DRAFT)121 b Fl(June)29 b(20,)j(2025)p │ │ │ │ │ +2777 100 V 1077 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 │ │ │ │ │ @@ -6018,19 +6009,19 @@ │ │ │ │ │ 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 1084 4 v │ │ │ │ │ -1265 w Fp(Utilities)28 b Fl(:)41 b Fk(DRAFT)30 b Fl(Ma)m(y)i(17,)f │ │ │ │ │ -(2024)p 2817 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 │ │ │ │ │ +TeXDict begin 8 7 bop 0 100 a Fq(8)p 136 100 1077 4 v │ │ │ │ │ +1258 w Fp(Utilities)28 b Fl(:)41 b Fk(DRAFT)30 b Fl(June)g(20,)h(2025)p │ │ │ │ │ +2824 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 │ │ │ │ │ @@ -6094,17 +6085,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 1084 4 v 1265 100 a Fp(Utilities)28 │ │ │ │ │ -b Fl(:)40 b Fk(DRAFT)122 b Fl(Ma)m(y)31 b(17,)h(2024)p │ │ │ │ │ -2770 100 V 1084 w Fq(9)0 399 y Fi(1.2.3)112 b Fh(ZV)38 │ │ │ │ │ +TeXDict begin 9 8 bop 91 100 1077 4 v 1258 100 a Fp(Utilities)28 │ │ │ │ │ +b Fl(:)41 b Fk(DRAFT)121 b Fl(June)29 b(20,)j(2025)p │ │ │ │ │ +2777 100 V 1077 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 │ │ │ │ │ @@ -6171,17 +6162,17 @@ │ │ │ │ │ 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 1061 4 │ │ │ │ │ -v 1243 w Fp(Utilities)28 b Fl(:)41 b Fk(DRAFT)30 b Fl(Ma)m(y)h(17,)h │ │ │ │ │ -(2024)p 2840 100 V 111 399 a Fq(8.)46 b Fp(void)h(ZVaxpy33)e(\()j(int)f │ │ │ │ │ +TeXDict begin 10 9 bop 0 100 a Fq(10)p 182 100 1054 4 │ │ │ │ │ +v 1236 w Fp(Utilities)28 b Fl(:)41 b Fk(DRAFT)30 b Fl(June)f(20,)j │ │ │ │ │ +(2025)p 2847 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 │ │ │ │ │ @@ -6217,17 +6208,17 @@ │ │ │ │ │ (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 1061 4 v 1242 100 a Fp(Utilities)28 │ │ │ │ │ -b Fl(:)41 b Fk(DRAFT)121 b Fl(Ma)m(y)31 b(17,)h(2024)p │ │ │ │ │ -2747 100 V 1061 w Fq(11)66 399 y(14.)46 b Fp(void)h(ZVaxpy13)e(\()j │ │ │ │ │ +TeXDict begin 11 10 bop 91 100 1054 4 v 1235 100 a Fp(Utilities)28 │ │ │ │ │ +b Fl(:)41 b Fk(DRAFT)121 b Fl(June)29 b(20,)j(2025)p │ │ │ │ │ +2754 100 V 1054 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 │ │ │ │ │ @@ -6274,17 +6265,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 1061 │ │ │ │ │ -4 v 1243 w Fp(Utilities)28 b Fl(:)41 b Fk(DRAFT)30 b │ │ │ │ │ -Fl(Ma)m(y)h(17,)h(2024)p 2840 100 V 277 462 a Fp(sums)p │ │ │ │ │ +TeXDict begin 12 11 bop 0 100 a Fq(12)p 182 100 1054 │ │ │ │ │ +4 v 1236 w Fp(Utilities)28 b Fl(:)41 b Fk(DRAFT)30 b │ │ │ │ │ +Fl(June)f(20,)j(2025)p 2847 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 │ │ │ │ │ @@ -6385,17 +6376,17 @@ │ │ │ │ │ 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 1061 4 v 1242 100 a Fp(Utilities)28 │ │ │ │ │ -b Fl(:)41 b Fk(DRAFT)121 b Fl(Ma)m(y)31 b(17,)h(2024)p │ │ │ │ │ -2747 100 V 1061 w Fq(13)66 399 y(26.)46 b Fp(int)h(ZVdotU22)f(\()h(int) │ │ │ │ │ +TeXDict begin 13 12 bop 91 100 1054 4 v 1235 100 a Fp(Utilities)28 │ │ │ │ │ +b Fl(:)41 b Fk(DRAFT)121 b Fl(June)29 b(20,)j(2025)p │ │ │ │ │ +2754 100 V 1054 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 │ │ │ │ │ @@ -6458,17 +6449,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 1061 │ │ │ │ │ -4 v 1243 w Fp(Utilities)28 b Fl(:)41 b Fk(DRAFT)30 b │ │ │ │ │ -Fl(Ma)m(y)h(17,)h(2024)p 2840 100 V 277 462 a Fp(sums)p │ │ │ │ │ +TeXDict begin 14 13 bop 0 100 a Fq(14)p 182 100 1054 │ │ │ │ │ +4 v 1236 w Fp(Utilities)28 b Fl(:)41 b Fk(DRAFT)30 b │ │ │ │ │ +Fl(June)f(20,)j(2025)p 2847 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 │ │ │ │ │ @@ -6574,17 +6565,17 @@ │ │ │ │ │ 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 1061 4 v 1242 100 a Fp(Utilities)28 │ │ │ │ │ -b Fl(:)41 b Fk(DRAFT)121 b Fl(Ma)m(y)31 b(17,)h(2024)p │ │ │ │ │ -2747 100 V 1061 w Fq(15)66 399 y(35.)46 b Fp(int)h(ZVdotC22)f(\()h(int) │ │ │ │ │ +TeXDict begin 15 14 bop 91 100 1054 4 v 1235 100 a Fp(Utilities)28 │ │ │ │ │ +b Fl(:)41 b Fk(DRAFT)121 b Fl(June)29 b(20,)j(2025)p │ │ │ │ │ +2754 100 V 1054 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 │ │ │ │ │ @@ -6652,17 +6643,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 1061 │ │ │ │ │ -4 v 1243 w Fp(Utilities)28 b Fl(:)41 b Fk(DRAFT)30 b │ │ │ │ │ -Fl(Ma)m(y)h(17,)h(2024)p 2840 100 V 66 399 a Fq(42.)46 │ │ │ │ │ +TeXDict begin 16 15 bop 0 100 a Fq(16)p 182 100 1054 │ │ │ │ │ +4 v 1236 w Fp(Utilities)28 b Fl(:)41 b Fk(DRAFT)30 b │ │ │ │ │ +Fl(June)f(20,)j(2025)p 2847 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 │ │ │ │ │ @@ -6719,17 +6710,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 1061 4 v 1242 100 a Fp(Utilities)28 │ │ │ │ │ -b Fl(:)41 b Fk(DRAFT)121 b Fl(Ma)m(y)31 b(17,)h(2024)p │ │ │ │ │ -2747 100 V 1061 w Fq(17)111 399 y(5.)46 b Fp(int)h(IVfp80)f(\()i(FILE)e │ │ │ │ │ +TeXDict begin 17 16 bop 91 100 1054 4 v 1235 100 a Fp(Utilities)28 │ │ │ │ │ +b Fl(:)41 b Fk(DRAFT)121 b Fl(June)29 b(20,)j(2025)p │ │ │ │ │ +2754 100 V 1054 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 │ │ │ │ │ @@ -6793,17 +6784,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 1061 │ │ │ │ │ -4 v 1243 w Fp(Utilities)28 b Fl(:)41 b Fk(DRAFT)30 b │ │ │ │ │ -Fl(Ma)m(y)h(17,)h(2024)p 2840 100 V 66 399 a Fq(16.)46 │ │ │ │ │ +TeXDict begin 18 17 bop 0 100 a Fq(18)p 182 100 1054 │ │ │ │ │ +4 v 1236 w Fp(Utilities)28 b Fl(:)41 b Fk(DRAFT)30 b │ │ │ │ │ +Fl(June)f(20,)j(2025)p 2847 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) │ │ │ │ │ @@ -6859,17 +6850,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 1061 4 v 1242 100 a Fp(Utilities)28 │ │ │ │ │ -b Fl(:)41 b Fk(DRAFT)121 b Fl(Ma)m(y)31 b(17,)h(2024)p │ │ │ │ │ -2747 100 V 1061 w Fq(19)111 399 y(2.)46 b Fp(float)h(*)g(FVinit2)f(\()h │ │ │ │ │ +TeXDict begin 19 18 bop 91 100 1054 4 v 1235 100 a Fp(Utilities)28 │ │ │ │ │ +b Fl(:)41 b Fk(DRAFT)121 b Fl(June)29 b(20,)j(2025)p │ │ │ │ │ +2754 100 V 1054 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 │ │ │ │ │ @@ -6929,17 +6920,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 1061 │ │ │ │ │ -4 v 1243 w Fp(Utilities)28 b Fl(:)41 b Fk(DRAFT)30 b │ │ │ │ │ -Fl(Ma)m(y)h(17,)h(2024)p 2840 100 V 66 399 a Fq(15.)46 │ │ │ │ │ +TeXDict begin 20 19 bop 0 100 a Fq(20)p 182 100 1054 │ │ │ │ │ +4 v 1236 w Fp(Utilities)28 b Fl(:)41 b Fk(DRAFT)30 b │ │ │ │ │ +Fl(June)f(20,)j(2025)p 2847 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 │ │ │ │ │ @@ -6994,17 +6985,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 1061 4 v 1242 100 a Fp(Utilities)28 │ │ │ │ │ -b Fl(:)41 b Fk(DRAFT)121 b Fl(Ma)m(y)31 b(17,)h(2024)p │ │ │ │ │ -2747 100 V 1061 w Fq(21)66 399 y(27.)46 b Fp(void)h(FVsub)f(\()i(int)f │ │ │ │ │ +TeXDict begin 21 20 bop 91 100 1054 4 v 1235 100 a Fp(Utilities)28 │ │ │ │ │ +b Fl(:)41 b Fk(DRAFT)121 b Fl(June)29 b(20,)j(2025)p │ │ │ │ │ +2754 100 V 1054 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 │ │ │ │ │ @@ -7067,17 +7058,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 1061 │ │ │ │ │ -4 v 1243 w Fp(Utilities)28 b Fl(:)41 b Fk(DRAFT)30 b │ │ │ │ │ -Fl(Ma)m(y)h(17,)h(2024)p 2840 100 V 111 399 a Fq(3.)46 │ │ │ │ │ +TeXDict begin 22 21 bop 0 100 a Fq(22)p 182 100 1054 │ │ │ │ │ +4 v 1236 w Fp(Utilities)28 b Fl(:)41 b Fk(DRAFT)30 b │ │ │ │ │ +Fl(June)f(20,)j(2025)p 2847 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 │ │ │ │ │ @@ -7136,17 +7127,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 1061 4 v 1242 100 a Fp(Utilities)28 │ │ │ │ │ -b Fl(:)41 b Fk(DRAFT)121 b Fl(Ma)m(y)31 b(17,)h(2024)p │ │ │ │ │ -2747 100 V 1061 w Fq(23)0 399 y Fi(1.2.9)112 b(Sorting)38 │ │ │ │ │ +TeXDict begin 23 22 bop 91 100 1054 4 v 1235 100 a Fp(Utilities)28 │ │ │ │ │ +b Fl(:)41 b Fk(DRAFT)121 b Fl(June)29 b(20,)j(2025)p │ │ │ │ │ +2754 100 V 1054 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 │ │ │ │ │ @@ -7196,17 +7187,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 1061 │ │ │ │ │ -4 v 1243 w Fp(Utilities)28 b Fl(:)41 b Fk(DRAFT)30 b │ │ │ │ │ -Fl(Ma)m(y)h(17,)h(2024)p 2840 100 V 111 399 a Fq(7.)46 │ │ │ │ │ +TeXDict begin 24 23 bop 0 100 a Fq(24)p 182 100 1054 │ │ │ │ │ +4 v 1236 w Fp(Utilities)28 b Fl(:)41 b Fk(DRAFT)30 b │ │ │ │ │ +Fl(June)f(20,)j(2025)p 2847 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 │ │ │ │ │ @@ -7263,17 +7254,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 1061 4 v 1242 100 a Fp(Utilities)28 │ │ │ │ │ -b Fl(:)41 b Fk(DRAFT)121 b Fl(Ma)m(y)31 b(17,)h(2024)p │ │ │ │ │ -2747 100 V 1061 w Fq(25)111 399 y(7.)46 b Fp(void)h(DVqsortUp)e(\()j │ │ │ │ │ +TeXDict begin 25 24 bop 91 100 1054 4 v 1235 100 a Fp(Utilities)28 │ │ │ │ │ +b Fl(:)41 b Fk(DRAFT)121 b Fl(June)29 b(20,)j(2025)p │ │ │ │ │ +2754 100 V 1054 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 │ │ │ │ │ @@ -7339,17 +7330,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 1061 │ │ │ │ │ -4 v 1243 w Fp(Utilities)28 b Fl(:)41 b Fk(DRAFT)30 b │ │ │ │ │ -Fl(Ma)m(y)h(17,)h(2024)p 2840 100 V 111 399 a Fq(5.)46 │ │ │ │ │ +TeXDict begin 26 25 bop 0 100 a Fq(26)p 182 100 1054 │ │ │ │ │ +4 v 1236 w Fp(Utilities)28 b Fl(:)41 b Fk(DRAFT)30 b │ │ │ │ │ +Fl(June)f(20,)j(2025)p 2847 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 │ │ │ │ │ @@ -7411,17 +7402,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 1061 4 v 1242 100 a Fp(Utilities)28 │ │ │ │ │ -b Fl(:)41 b Fk(DRAFT)121 b Fl(Ma)m(y)31 b(17,)h(2024)p │ │ │ │ │ -2747 100 V 1061 w Fq(27)111 399 y(5.)46 b Fp(IP)h(*)h(IP_mergeUp)d(\()i │ │ │ │ │ +TeXDict begin 27 26 bop 91 100 1054 4 v 1235 100 a Fp(Utilities)28 │ │ │ │ │ +b Fl(:)41 b Fk(DRAFT)121 b Fl(June)29 b(20,)j(2025)p │ │ │ │ │ +2754 100 V 1054 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 │ │ │ │ │ @@ -7479,17 +7470,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 1061 │ │ │ │ │ -4 v 1243 w Fp(Utilities)28 b Fl(:)41 b Fk(DRAFT)30 b │ │ │ │ │ -Fl(Ma)m(y)h(17,)h(2024)p 2840 100 V 111 399 a Fq(3.)46 │ │ │ │ │ +TeXDict begin 28 27 bop 0 100 a Fq(28)p 182 100 1054 │ │ │ │ │ +4 v 1236 w Fp(Utilities)28 b Fl(:)41 b Fk(DRAFT)30 b │ │ │ │ │ +Fl(June)f(20,)j(2025)p 2847 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) │ │ │ │ │ @@ -7539,17 +7530,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 1061 4 v 1242 100 a Fp(Utilities)28 │ │ │ │ │ -b Fl(:)41 b Fk(DRAFT)121 b Fl(Ma)m(y)31 b(17,)h(2024)p │ │ │ │ │ -2747 100 V 1061 w Fq(29)337 399 y Fm(\210)45 b Fq(The)33 │ │ │ │ │ +TeXDict begin 29 28 bop 91 100 1054 4 v 1235 100 a Fp(Utilities)28 │ │ │ │ │ +b Fl(:)41 b Fk(DRAFT)121 b Fl(June)29 b(20,)j(2025)p │ │ │ │ │ +2754 100 V 1054 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 │ │ │ │ │ @@ -7614,17 +7605,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 1061 4 v 1242 100 a Fp(Utilities)28 │ │ │ │ │ -b Fl(:)41 b Fk(DRAFT)121 b Fl(Ma)m(y)31 b(17,)h(2024)p │ │ │ │ │ -2747 100 V 1061 w Fq(31)0 399 y Fp(FVfprintf\(\))p Fq(,)c(16)0 │ │ │ │ │ +TeXDict begin 31 30 bop 91 100 1054 4 v 1235 100 a Fp(Utilities)28 │ │ │ │ │ +b Fl(:)41 b Fk(DRAFT)121 b Fl(June)29 b(20,)j(2025)p │ │ │ │ │ +2754 100 V 1054 w Fq(31)0 399 y Fp(FVfprintf\(\))p Fq(,)c(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 │ │ │ │ │ @@ -7683,17 +7674,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 1061 │ │ │ │ │ -4 v 1243 w Fp(Utilities)28 b Fl(:)41 b Fk(DRAFT)30 b │ │ │ │ │ -Fl(Ma)m(y)h(17,)h(2024)p 2840 100 V 0 399 a Fp(IVZVisortDown\(\))p │ │ │ │ │ +TeXDict begin 32 31 bop 0 100 a Fq(32)p 182 100 1054 │ │ │ │ │ +4 v 1236 w Fp(Utilities)28 b Fl(:)41 b Fk(DRAFT)30 b │ │ │ │ │ +Fl(June)f(20,)j(2025)p 2847 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 May 17, 2024 │ │ │ │ │ │ + 2 Utilities : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 3 │ │ │ │ │ │ + Utilities : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 4 Utilities : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 5 │ │ │ │ │ │ + Utilities : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 6 Utilities : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 7 │ │ │ │ │ │ + Utilities : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 8 Utilities : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 9 │ │ │ │ │ │ + Utilities : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 10 Utilities : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 11 │ │ │ │ │ │ + Utilities : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 12 Utilities : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 13 │ │ │ │ │ │ + Utilities : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 14 Utilities : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 15 │ │ │ │ │ │ + Utilities : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 16 Utilities : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 17 │ │ │ │ │ │ + Utilities : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 18 Utilities : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 19 │ │ │ │ │ │ + Utilities : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 20 Utilities : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 21 │ │ │ │ │ │ + Utilities : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 22 Utilities : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 23 │ │ │ │ │ │ + Utilities : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 24 Utilities : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 25 │ │ │ │ │ │ + Utilities : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 26 Utilities : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 27 │ │ │ │ │ │ + Utilities : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 28 Utilities : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 29 │ │ │ │ │ │ + Utilities : DRAFT June 20, 2025 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 May 17, 2024 31 │ │ │ │ │ │ + Utilities : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 32 Utilities : DRAFT June 20, 2025 │ │ │ │ │ │ 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 2024.05.17:2218 │ │ │ │ │ +%DVIPSSource: TeX output 2025.06.20:0450 │ │ │ │ │ %%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 │ │ │ │ │ @@ -2350,22 +2350,21 @@ │ │ │ │ │ /UnderlinePosition -100 def │ │ │ │ │ /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 49 /one put │ │ │ │ │ dup 50 /two put │ │ │ │ │ -dup 52 /four put │ │ │ │ │ -dup 55 /seven put │ │ │ │ │ +dup 53 /five put │ │ │ │ │ dup 58 /colon put │ │ │ │ │ -dup 77 /M put │ │ │ │ │ -dup 97 /a put │ │ │ │ │ -dup 121 /y put │ │ │ │ │ +dup 74 /J put │ │ │ │ │ +dup 101 /e put │ │ │ │ │ +dup 110 /n put │ │ │ │ │ +dup 117 /u put │ │ │ │ │ readonly def │ │ │ │ │ currentdict end │ │ │ │ │ currentfile eexec │ │ │ │ │ D9D66F633B846AB284BCF8B0411B772DE5CE32340DC6F28AF40857E4451976E7 │ │ │ │ │ 5182433CF9F333A38BD841C0D4E68BF9E012EB32A8FFB76B5816306B5EDF7C99 │ │ │ │ │ 8B3A16D9B4BC056662E32C7CD0123DFAEB734C7532E64BBFBF5A60336E646716 │ │ │ │ │ EFB852C877F440D329172C71F1E5D59CE9473C26B8AEF7AD68EF0727B6EC2E0C │ │ │ │ │ @@ -2546,72 +2545,64 @@ │ │ │ │ │ 7CA1534C4D5B05FC33F83790ECFD7641DF3FB94289E2A1F6E7D29AB1228A867A │ │ │ │ │ 6E1EF0E9C6F899B491DC18401C2C0A05FFFED46A72C245F7529B8EA55A038082 │ │ │ │ │ 8512307217D2A233C37004085BA3AEE379269F9FA7D0ADB4B19A95CC2AFE686E │ │ │ │ │ 55D88E47257C1FE6F235FEA295910569FE6DD5995512562359CC821E85A6C7A5 │ │ │ │ │ 79B470A9E340A6985189FF8B6AF914A6B0ECF93F47903221F95DE894A8F05B05 │ │ │ │ │ B7D99CD533EC5F931B18E6B39BECF67FA2D6DD1AEC76772B068BE06335A94C05 │ │ │ │ │ 7A4DDEE77B66101DA855C17AC312600370B34E31F5EC3A01300A8EB60B4C9767 │ │ │ │ │ -1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004B9BA1CC │ │ │ │ │ -580D3C6BDA4DC1B80B4365F1C80512453FC5316EC2D928FB731C3D6403E3C18B │ │ │ │ │ -E8424D644DF5E9A2134229C5C91CA68DB8E85BA2BB40F538F585DA6FA4037718 │ │ │ │ │ -B8053EBBA1E765346BCD5BDAA6C38115D31611D8A87A2238C145F2DA2F92E4DF │ │ │ │ │ -3987BD9C4D2A3D460E8941A68B125BCD9EE4F9FD262C4C8A71F47A2C81975635 │ │ │ │ │ -F1B981C274C53FA2ACCDE4C9D0A7C62D6C1EFF91CFC6712CA6A9F333C9564FCB │ │ │ │ │ -2A70F0AD715A79B10A08AB069E2A3C93BC0AED19D0CA10134B8DDDE8AF548DB2 │ │ │ │ │ -3A4AAA9C29682CF135BB767DAA16169A127EB50A7EECEB6480CF56A7D0F8AC56 │ │ │ │ │ -4A5090B3D75A790372886AF568D94C8165975A05BFBFDF1FFBA45F70700BB9E0 │ │ │ │ │ -57F3249EF9E9C8AD9CBCF6E4FD592DC4CDD2CC7C0BC3130C1059096C657BE453 │ │ │ │ │ -A2CBACE93420210E27AF56CA229BD6D982FB68B3FDC6D44478B922C4231C47EE │ │ │ │ │ -E500232F6C11D92DEB955F66DF52B92B22E7352790CC2DCBAC53965D57AC2920 │ │ │ │ │ -68B7D520DE25047146EFEB06B9AD4E2A94243C7E5239F0BC2FC312B16051D52C │ │ │ │ │ -0B92C217B6B42997321AE4F8BB066754B7AA3F15069EF59224E8A442CE471AA7 │ │ │ │ │ -E8049A3DD9EDA09CCEE4998998661CF7DB35E952F6C65DAEB3013951C59F3E09 │ │ │ │ │ -157F313B0237876E1C0190F0473819570B8C0205AADF05D787CC00979CFB327A │ │ │ │ │ -289382B22DDA6F12804ED0ED5B179E36A995A2A59E1B66E75130DBE9109C813B │ │ │ │ │ -94403E0DEA8314A1E9DB474D7FA83C0BAFD08033E6A6215844C1D26BE15F1251 │ │ │ │ │ -A1605E8DF9A9C601ED37379530BC1C82BE5463C6C711C5652BFD6262485AA9CA │ │ │ │ │ -B8C4A117593001D08D980041E2A83C190DCE8E6CD3D334E5CC19FC05DB30F7F7 │ │ │ │ │ -24A305C4DBB31F0651392B99D44B4302333BDF7E326FD256DD75D309C6E73F85 │ │ │ │ │ -FA71B35FD1F9BEFF4C7A1076362EEB0A85492933B6006086A7B8C1928CF2D1EE │ │ │ │ │ -FD4344409257BB802C117E739960821CD3C88BFBA5669FF16F610AD638AF3677 │ │ │ │ │ -8674C985E6767253ED5769F71BEA5E9BB02A751F9E62EE2B18AC19D975FDEAE9 │ │ │ │ │ -8B8822367FF177A7E850766DE99ED3366D46464612926430012212A90F8E85F4 │ │ │ │ │ -4760B40D5B86B90819EE410382C23E86DCAF4F0FF5DFEB2C285965F4DCF2FB2B │ │ │ │ │ -457C0A0427A8D4ADA514E9DACD0F9367E1DA225DB21DA4DDAE33F2B529686D92 │ │ │ │ │ -AC085B345565F9DFFA012FD494DBB2E0B44A0787B2B72DC8D25399DAAE8864B7 │ │ │ │ │ -E84AA99DAFCEAF18F8B41882720316450F1B1CA48B418C9736E5CE4AFF996111 │ │ │ │ │ -5F7FE80958B6A3498508E9693CB134402D92E30D4C2939070D4647E13682290E │ │ │ │ │ -1D0820A3FCA7147157D09D1A40771F214EAE7DD743EA26839E535CA186C05CB8 │ │ │ │ │ -4874988AA1104D85AF0220FE7224344FF624E794BD2454E1C0AC971522FBECBA │ │ │ │ │ -B2497F25CD621B77EC5160973EF5ECC39C183DC051B0DFCB090194A2525BD96E │ │ │ │ │ -28593FDA80D8D259F039416D5F9AF0AD3C9A105B49DAF6E681921E369B7666C6 │ │ │ │ │ -2B73DB37447B00AE96317C2F1C44FB6E6EFD740BAB20FA03A8CE018EC8415582 │ │ │ │ │ -FB06E88A2971E3A480FB1EB4FE93CC7E5179721CAABEE88742B13CF0405F49F4 │ │ │ │ │ -945E587668C821D8C06D6847B6DF84CAFFCD4628670D551FC5F7236875BE1207 │ │ │ │ │ -634BA7F70A19B658FAE7D86F6D00ED28FBF29CC585DEE279325EEF8B0CCB6149 │ │ │ │ │ -E46E638C73D75148F18A636DBC2DD96ED34F68A5A09A3700B1EA34B2D142807C │ │ │ │ │ -F8709D81180783548EAE6F457BF968602076A1069163E3C15BBCEF659C6CF2E6 │ │ │ │ │ -0BB01BDC8E503802CC7969A5B8477E9788C5249B23B19669F5075E089738E49A │ │ │ │ │ -8671D7C1B1B47652F3D78BF2FF74EDB44BA5B092E8D5B85001E97F69D54AEEFC │ │ │ │ │ -88FC3CA1B0D5BAC39263B371005BCFA19AD197A31CC34D0BD55C2CA18C60C485 │ │ │ │ │ -5993F736EF1DD2C5D2B4D50B3D498861B4DF5E7AFF614BBCA4C2E6BECC0DCEF5 │ │ │ │ │ -95F0D686188014C530D8E37650CDCAE721B4AFB0F178BC744BDDDED45DAB7FEB │ │ │ │ │ -A10B975E26099E3DC61116D6BF554574F948895B88EEFE03DCC5351190836AD4 │ │ │ │ │ -EBC1AC55C6D099A8E7B0A372D290C481F44FA464B9C11A0BC991CB045E0AAAC4 │ │ │ │ │ -5C73CA43A4F17D1ADDD33D1B917FF95BFF411C8409F41553B1BC97DE47E3A1F4 │ │ │ │ │ -A5C1D1B7B1BF7E2507AC53956C141411F4F657E37981996DD7BB7ADB2CB6AE01 │ │ │ │ │ -73D0876B8F896F626D5022FE53BA34D5668BD698BE8D5CCAD083CBCEF440BE6A │ │ │ │ │ -8090EB1CDEE5F99C8988650BD4E539B357C31C597D8A9104A9D5967D4E906CAD │ │ │ │ │ -2A65575A884B1C5F6CC509E742FA9DDD66494F219178161AF72C50848E226A95 │ │ │ │ │ -A8C247FF9FF0BABD073021271B5C0692F9BE220071DAB09E5A026629371EE3C4 │ │ │ │ │ -A6E4FA94625D87A5B66EF077ED54C72B1052AEAA9637B30C76EF8EB04AD5F476 │ │ │ │ │ -D15F1C93C0BC6E0F67B366097BBED03FE82C040F9EF02866159B46854E11D44F │ │ │ │ │ -54AE6748A7E61B993A4EECD3B8BE3B5897A66BBCDFE24F65BC2AD5AB49048CF1 │ │ │ │ │ -647203823F84DF5CB483096F9D96AEE3A2855E479B72A14A67C633CE99C101CF │ │ │ │ │ -EFAE939BF9B02E710D │ │ │ │ │ +1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004ACD1870 │ │ │ │ │ +A5EA947858F5795870BFE1343AD803FB854BF8F5A4E794E8EC57BE41DB5B8734 │ │ │ │ │ +13E47950F29A81EA0C81EA798863883D7F41F78325CA190CBBFFE822AE494550 │ │ │ │ │ +4BE83703071FC9512D128927AF3F63CEF8F86ABE1E15D7B4DDD39576E7DFF45E │ │ │ │ │ +3CB4115AAB1830DE8647B915DB4BEBEB5235C281E098B899BAB951D8D5798F01 │ │ │ │ │ +7F7C47336D31438E5126738AFEAB29E9A7CBE06DE4DD604477B542D2620DFD58 │ │ │ │ │ +28FE34238572F23C5A8EB7ACEE1E154DA13FC1A5AA67A3BA8C5CDFB2B80312C9 │ │ │ │ │ +BC9FAE56D08DDFA9498E6EF0D0F6BD18B3923E0B670B0740528BC843610736CB │ │ │ │ │ +80228C105C2F72C3C22D610C3D8C268DEEA2AEEE3221E198E79FE2966487360C │ │ │ │ │ +84AE08AC326F48B21447652121B1EB68AF856055EEA65B6B625BF622CBFC2D1C │ │ │ │ │ +EF943CC4CAF2C715782C9EF9A9BA4689BFC6B6A82F8D55795BE8111E2C7DE520 │ │ │ │ │ +367362304B6A48186C842033E715A46265A352472F4F7313248EBCD26BEA97E7 │ │ │ │ │ +B814A61D4B7ADCB5C5F21AA34E0C1269E8426DBFB511DE6E26B960456C8F8520 │ │ │ │ │ +5F0DD382289A62AF0B935EDB5B2394538C5F0EE72962D2F98F3C38CD7C027B9F │ │ │ │ │ +E230E67E40FEFBDED06B3423C9DFD669E6B5BC913E0FF75786A64A6C11D4FE89 │ │ │ │ │ +1B918DC0E953C52CFD153063CD0D2A78B43F8712243845E6F2CBA1DB610F403D │ │ │ │ │ +A98D06D95FF44C7AC029092B666A8B0DCEA95B34F5ACC10E8611BADE6A24469C │ │ │ │ │ +0C01D95BFB445FA22CD38D033E4D24E006BB9D54EE41EF7AD5AC9C299721F61A │ │ │ │ │ +F01B6EDCDF428BD9195A13C5B1027358F8A203F828A1DD9622243B2D76C6F1BA │ │ │ │ │ +9F2D7E9D4879FC668ABC750CD25415DC6CCF2257C28F78D3F9BE499CC0FF2F80 │ │ │ │ │ +2C2CD1DEFABD6668FCA76E1D629A344333E33DA24B86D2E9F8F5EE1C29974640 │ │ │ │ │ +C3E78E999BAB313400041DADDDFDBFFCC419F129A84F4D412B79E8BE4511CA00 │ │ │ │ │ +F92A4F3CDD2E51345D3965C104F06B6503445DC20224CB7606A9D7D5F9EE45E6 │ │ │ │ │ +1B2963DA96AA2AB1BA5BE29656E666E4D0E122DE58EEA68E04ED76438DA03E65 │ │ │ │ │ +B80055A86B7B2A26BAE6BBB8835E17F9696E9B3CD34571BA75C76D4D2CCC48F1 │ │ │ │ │ +7534C1EF9127E374D65D05B8072E08D6C72A0B4A35EA0DD717743C66D105CCD8 │ │ │ │ │ +7355F13E9C38C1A4351624E689ED7909100942FA0474842EE44DEC3279E1A1CD │ │ │ │ │ +8064666EB845CA7C3E906B67C0BF96A28D514DB2E4A1E4AF287350B03762A2CF │ │ │ │ │ +13B18AC3F5D2F3B74A1D50267C03EFB74B888E1D24ABEEA4A885F4D0BF14C0D8 │ │ │ │ │ +289AC79D6D98E2A2C831672FB1F3457564CD161ADC3AF610D88201AB5B0C10CB │ │ │ │ │ +5ECCC2D5C4AF39C8CB3044BF9EC791BA45D29C2B51EA0483D19822C264CE6FA3 │ │ │ │ │ +5C97F2DF5A78CB93528E99B9ED7CB121C83130C129B849B52A36EBD88AF19DD3 │ │ │ │ │ +C5CABE831027388EF86BD5CBD90AAAC089775938A321C44D4DDA67A51312D8AB │ │ │ │ │ +C509DDBE7044A107AB2BE9C4C9556F85C529B174A7778B489BF28EC07A834542 │ │ │ │ │ +8B31F2925C21FB2096877711F998763D5A8495002B8E080AF8DBB1B3106EDDBA │ │ │ │ │ +35121D52E0846A7AF3ABEDF87BDE4FA665673A9B80CA538B98F873947AA17EF4 │ │ │ │ │ +9BB182917E9D79BC7EC681E93710D6A1D6B0E4A7FA9452FC1C431808174F3AB7 │ │ │ │ │ +F3914FBC86CB34E8583457243C3C7BE4BC166C7397689BC6FFB82EA2967E88EE │ │ │ │ │ +464F96EDA144DE2B64401B8E577ABCA2D826FE0B92E21FFAE3E81EBB6B6EB36E │ │ │ │ │ +9B1A8FE3884CA398C03135FD49D51724FC1268E9482E41FAEA2FC6C809006B8F │ │ │ │ │ +5D4F9E038450AD3A6041C16FD1C7E5FC80C0E033CE57E64863E014531D94DF1E │ │ │ │ │ +31D7D038AFCB60715AA73C1E96F113A24C5AF35BBEB61C4D079ED034ED83AA4A │ │ │ │ │ +E12448E618330463304788BCF40561CD63167B3BF144F408E2B89E60B8BA13EF │ │ │ │ │ +3B57D286FD23D4FA8BAEFF98DC1188B1982956CC1DCAEFC7D949B7B4E3BE8F8A │ │ │ │ │ +BFE2C9D938DD13EFEE7123576608D9396F260907DA98AE2D3DD5822306CBC8A6 │ │ │ │ │ +B083C697DDA3C62EE7879436A9FD8EE0034B105105B3F122F893EA2126EBE8A9 │ │ │ │ │ +5CBF2BD248DD9FBEF0040C25797BD13B69A8C9F0D4E4F935C61ED30487CCDB1A │ │ │ │ │ +0339006E78EE1755929D2412776EC7DB1F666DBDD28EA8AC7397F809C7F38A41 │ │ │ │ │ +5B3BF6C75F4F35C90141EB08377AF452CF840FEA938805F9D14E02DC29215B4E │ │ │ │ │ +F1EB │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ @@ -3994,19 +3985,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 23[45 19[83 18[25 2[45 │ │ │ │ │ -2[45 1[45 45 45 3[25 44[{}10 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 138[51 6[51 8[40 26[47 15[25 4[45 │ │ │ │ │ +2[45 1[45 3[25 44[{}9 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 │ │ │ │ │ @@ -4122,17 +4113,17 @@ │ │ │ │ │ (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 1256 4 v │ │ │ │ │ -1438 w Fj(ZV)29 b Fg(:)i Ff(DRAFT)f Fg(Ma)m(y)i(17,)f(2024)p │ │ │ │ │ -2645 100 V 137 399 a Fi(\210)45 b Fj(int)i(size)29 b │ │ │ │ │ +TeXDict begin 2 1 bop 0 100 a Fk(2)p 136 100 1249 4 v │ │ │ │ │ +1431 w Fj(ZV)29 b Fg(:)i Ff(DRAFT)f Fg(June)g(20,)h(2025)p │ │ │ │ │ +2652 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 │ │ │ │ │ @@ -4187,17 +4178,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 1256 4 v 1437 100 a Fj(ZV)30 │ │ │ │ │ -b Fg(:)g Ff(DRAFT)121 b Fg(Ma)m(y)32 b(17,)f(2024)p 2597 │ │ │ │ │ -100 V 1256 w Fk(3)0 399 y Fd(1.2.2)112 b(Instance)38 │ │ │ │ │ +TeXDict begin 3 2 bop 91 100 1249 4 v 1430 100 a Fj(ZV)30 │ │ │ │ │ +b Fg(:)g Ff(DRAFT)122 b Fg(June)29 b(20,)i(2025)p 2604 │ │ │ │ │ +100 V 1249 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 │ │ │ │ │ @@ -4261,17 +4252,17 @@ │ │ │ │ │ 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 1256 4 v │ │ │ │ │ -1438 w Fj(ZV)29 b Fg(:)i Ff(DRAFT)f Fg(Ma)m(y)i(17,)f(2024)p │ │ │ │ │ -2645 100 V 111 399 a Fk(8.)46 b Fj(void)h(ZV_setEntry)e(\()i(ZV)g(*zv,) │ │ │ │ │ +TeXDict begin 4 3 bop 0 100 a Fk(4)p 136 100 1249 4 v │ │ │ │ │ +1431 w Fj(ZV)29 b Fg(:)i Ff(DRAFT)f Fg(June)g(20,)h(2025)p │ │ │ │ │ +2652 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 │ │ │ │ │ @@ -4347,17 +4338,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 1256 4 v 1437 100 a Fj(ZV)30 │ │ │ │ │ -b Fg(:)g Ff(DRAFT)121 b Fg(Ma)m(y)32 b(17,)f(2024)p 2597 │ │ │ │ │ -100 V 1256 w Fk(5)0 399 y Fd(1.2.4)112 b(Utilit)m(y)38 │ │ │ │ │ +TeXDict begin 5 4 bop 91 100 1249 4 v 1430 100 a Fj(ZV)30 │ │ │ │ │ +b Fg(:)g Ff(DRAFT)122 b Fg(June)29 b(20,)i(2025)p 2604 │ │ │ │ │ +100 V 1249 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 │ │ │ │ │ @@ -4417,17 +4408,17 @@ │ │ │ │ │ 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 1256 4 v │ │ │ │ │ -1438 w Fj(ZV)29 b Fg(:)i Ff(DRAFT)f Fg(Ma)m(y)i(17,)f(2024)p │ │ │ │ │ -2645 100 V 111 399 a Fk(8.)46 b Fj(void)h(ZV_log10profile)d(\()j(ZV)g │ │ │ │ │ +TeXDict begin 6 5 bop 0 100 a Fk(6)p 136 100 1249 4 v │ │ │ │ │ +1431 w Fj(ZV)29 b Fg(:)i Ff(DRAFT)f Fg(June)g(20,)h(2025)p │ │ │ │ │ +2652 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) │ │ │ │ │ @@ -4509,17 +4500,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 1256 4 v 1437 100 a Fj(ZV)30 │ │ │ │ │ -b Fg(:)g Ff(DRAFT)121 b Fg(Ma)m(y)32 b(17,)f(2024)p 2597 │ │ │ │ │ -100 V 1256 w Fk(7)111 399 y(6.)46 b Fj(int)h(ZV_writeToBinaryFile)42 │ │ │ │ │ +TeXDict begin 7 6 bop 91 100 1249 4 v 1430 100 a Fj(ZV)30 │ │ │ │ │ +b Fg(:)g Ff(DRAFT)122 b Fg(June)29 b(20,)i(2025)p 2604 │ │ │ │ │ +100 V 1249 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 │ │ │ │ │ @@ -4575,17 +4566,17 @@ │ │ │ │ │ 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 1256 4 v │ │ │ │ │ -1438 w Fj(ZV)29 b Fg(:)i Ff(DRAFT)f Fg(Ma)m(y)i(17,)f(2024)p │ │ │ │ │ -2645 100 V 337 399 a Fi(\210)45 b Fk(The)40 b Fj(outFile)f │ │ │ │ │ +TeXDict begin 8 7 bop 0 100 a Fk(8)p 136 100 1249 4 v │ │ │ │ │ +1431 w Fj(ZV)29 b Fg(:)i Ff(DRAFT)f Fg(June)g(20,)h(2025)p │ │ │ │ │ +2652 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 │ │ │ │ │ ├── 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 May 17, 2024 │ │ │ │ │ │ + 2 ZV : DRAFT June 20, 2025 │ │ │ │ │ │ • 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 May 17, 2024 3 │ │ │ │ │ │ + ZV : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 4 ZV : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 5 │ │ │ │ │ │ + ZV : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 6 ZV : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 7 │ │ │ │ │ │ + ZV : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 8 ZV : DRAFT June 20, 2025 │ │ │ │ │ │ • 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 2024.05.17:2218 │ │ │ │ │ +%DVIPSSource: TeX output 2025.06.20:0450 │ │ │ │ │ %%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 │ │ │ │ │ @@ -2250,22 +2250,21 @@ │ │ │ │ │ /UnderlinePosition -100 def │ │ │ │ │ /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 49 /one put │ │ │ │ │ dup 50 /two put │ │ │ │ │ -dup 52 /four put │ │ │ │ │ -dup 55 /seven put │ │ │ │ │ +dup 53 /five put │ │ │ │ │ dup 58 /colon put │ │ │ │ │ -dup 77 /M put │ │ │ │ │ -dup 97 /a put │ │ │ │ │ -dup 121 /y put │ │ │ │ │ +dup 74 /J put │ │ │ │ │ +dup 101 /e put │ │ │ │ │ +dup 110 /n put │ │ │ │ │ +dup 117 /u put │ │ │ │ │ readonly def │ │ │ │ │ currentdict end │ │ │ │ │ currentfile eexec │ │ │ │ │ D9D66F633B846AB284BCF8B0411B772DE5CE32340DC6F28AF40857E4451976E7 │ │ │ │ │ 5182433CF9F333A38BD841C0D4E68BF9E012EB32A8FFB76B5816306B5EDF7C99 │ │ │ │ │ 8B3A16D9B4BC056662E32C7CD0123DFAEB734C7532E64BBFBF5A60336E646716 │ │ │ │ │ EFB852C877F440D329172C71F1E5D59CE9473C26B8AEF7AD68EF0727B6EC2E0C │ │ │ │ │ @@ -2446,72 +2445,64 @@ │ │ │ │ │ 7CA1534C4D5B05FC33F83790ECFD7641DF3FB94289E2A1F6E7D29AB1228A867A │ │ │ │ │ 6E1EF0E9C6F899B491DC18401C2C0A05FFFED46A72C245F7529B8EA55A038082 │ │ │ │ │ 8512307217D2A233C37004085BA3AEE379269F9FA7D0ADB4B19A95CC2AFE686E │ │ │ │ │ 55D88E47257C1FE6F235FEA295910569FE6DD5995512562359CC821E85A6C7A5 │ │ │ │ │ 79B470A9E340A6985189FF8B6AF914A6B0ECF93F47903221F95DE894A8F05B05 │ │ │ │ │ B7D99CD533EC5F931B18E6B39BECF67FA2D6DD1AEC76772B068BE06335A94C05 │ │ │ │ │ 7A4DDEE77B66101DA855C17AC312600370B34E31F5EC3A01300A8EB60B4C9767 │ │ │ │ │ -1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004B9BA1CC │ │ │ │ │ -580D3C6BDA4DC1B80B4365F1C80512453FC5316EC2D928FB731C3D6403E3C18B │ │ │ │ │ -E8424D644DF5E9A2134229C5C91CA68DB8E85BA2BB40F538F585DA6FA4037718 │ │ │ │ │ -B8053EBBA1E765346BCD5BDAA6C38115D31611D8A87A2238C145F2DA2F92E4DF │ │ │ │ │ -3987BD9C4D2A3D460E8941A68B125BCD9EE4F9FD262C4C8A71F47A2C81975635 │ │ │ │ │ -F1B981C274C53FA2ACCDE4C9D0A7C62D6C1EFF91CFC6712CA6A9F333C9564FCB │ │ │ │ │ -2A70F0AD715A79B10A08AB069E2A3C93BC0AED19D0CA10134B8DDDE8AF548DB2 │ │ │ │ │ -3A4AAA9C29682CF135BB767DAA16169A127EB50A7EECEB6480CF56A7D0F8AC56 │ │ │ │ │ -4A5090B3D75A790372886AF568D94C8165975A05BFBFDF1FFBA45F70700BB9E0 │ │ │ │ │ -57F3249EF9E9C8AD9CBCF6E4FD592DC4CDD2CC7C0BC3130C1059096C657BE453 │ │ │ │ │ -A2CBACE93420210E27AF56CA229BD6D982FB68B3FDC6D44478B922C4231C47EE │ │ │ │ │ -E500232F6C11D92DEB955F66DF52B92B22E7352790CC2DCBAC53965D57AC2920 │ │ │ │ │ -68B7D520DE25047146EFEB06B9AD4E2A94243C7E5239F0BC2FC312B16051D52C │ │ │ │ │ -0B92C217B6B42997321AE4F8BB066754B7AA3F15069EF59224E8A442CE471AA7 │ │ │ │ │ -E8049A3DD9EDA09CCEE4998998661CF7DB35E952F6C65DAEB3013951C59F3E09 │ │ │ │ │ -157F313B0237876E1C0190F0473819570B8C0205AADF05D787CC00979CFB327A │ │ │ │ │ -289382B22DDA6F12804ED0ED5B179E36A995A2A59E1B66E75130DBE9109C813B │ │ │ │ │ -94403E0DEA8314A1E9DB474D7FA83C0BAFD08033E6A6215844C1D26BE15F1251 │ │ │ │ │ -A1605E8DF9A9C601ED37379530BC1C82BE5463C6C711C5652BFD6262485AA9CA │ │ │ │ │ -B8C4A117593001D08D980041E2A83C190DCE8E6CD3D334E5CC19FC05DB30F7F7 │ │ │ │ │ -24A305C4DBB31F0651392B99D44B4302333BDF7E326FD256DD75D309C6E73F85 │ │ │ │ │ -FA71B35FD1F9BEFF4C7A1076362EEB0A85492933B6006086A7B8C1928CF2D1EE │ │ │ │ │ -FD4344409257BB802C117E739960821CD3C88BFBA5669FF16F610AD638AF3677 │ │ │ │ │ -8674C985E6767253ED5769F71BEA5E9BB02A751F9E62EE2B18AC19D975FDEAE9 │ │ │ │ │ -8B8822367FF177A7E850766DE99ED3366D46464612926430012212A90F8E85F4 │ │ │ │ │ -4760B40D5B86B90819EE410382C23E86DCAF4F0FF5DFEB2C285965F4DCF2FB2B │ │ │ │ │ -457C0A0427A8D4ADA514E9DACD0F9367E1DA225DB21DA4DDAE33F2B529686D92 │ │ │ │ │ -AC085B345565F9DFFA012FD494DBB2E0B44A0787B2B72DC8D25399DAAE8864B7 │ │ │ │ │ -E84AA99DAFCEAF18F8B41882720316450F1B1CA48B418C9736E5CE4AFF996111 │ │ │ │ │ -5F7FE80958B6A3498508E9693CB134402D92E30D4C2939070D4647E13682290E │ │ │ │ │ -1D0820A3FCA7147157D09D1A40771F214EAE7DD743EA26839E535CA186C05CB8 │ │ │ │ │ -4874988AA1104D85AF0220FE7224344FF624E794BD2454E1C0AC971522FBECBA │ │ │ │ │ -B2497F25CD621B77EC5160973EF5ECC39C183DC051B0DFCB090194A2525BD96E │ │ │ │ │ -28593FDA80D8D259F039416D5F9AF0AD3C9A105B49DAF6E681921E369B7666C6 │ │ │ │ │ -2B73DB37447B00AE96317C2F1C44FB6E6EFD740BAB20FA03A8CE018EC8415582 │ │ │ │ │ -FB06E88A2971E3A480FB1EB4FE93CC7E5179721CAABEE88742B13CF0405F49F4 │ │ │ │ │ -945E587668C821D8C06D6847B6DF84CAFFCD4628670D551FC5F7236875BE1207 │ │ │ │ │ -634BA7F70A19B658FAE7D86F6D00ED28FBF29CC585DEE279325EEF8B0CCB6149 │ │ │ │ │ -E46E638C73D75148F18A636DBC2DD96ED34F68A5A09A3700B1EA34B2D142807C │ │ │ │ │ -F8709D81180783548EAE6F457BF968602076A1069163E3C15BBCEF659C6CF2E6 │ │ │ │ │ -0BB01BDC8E503802CC7969A5B8477E9788C5249B23B19669F5075E089738E49A │ │ │ │ │ -8671D7C1B1B47652F3D78BF2FF74EDB44BA5B092E8D5B85001E97F69D54AEEFC │ │ │ │ │ -88FC3CA1B0D5BAC39263B371005BCFA19AD197A31CC34D0BD55C2CA18C60C485 │ │ │ │ │ -5993F736EF1DD2C5D2B4D50B3D498861B4DF5E7AFF614BBCA4C2E6BECC0DCEF5 │ │ │ │ │ -95F0D686188014C530D8E37650CDCAE721B4AFB0F178BC744BDDDED45DAB7FEB │ │ │ │ │ -A10B975E26099E3DC61116D6BF554574F948895B88EEFE03DCC5351190836AD4 │ │ │ │ │ -EBC1AC55C6D099A8E7B0A372D290C481F44FA464B9C11A0BC991CB045E0AAAC4 │ │ │ │ │ -5C73CA43A4F17D1ADDD33D1B917FF95BFF411C8409F41553B1BC97DE47E3A1F4 │ │ │ │ │ -A5C1D1B7B1BF7E2507AC53956C141411F4F657E37981996DD7BB7ADB2CB6AE01 │ │ │ │ │ -73D0876B8F896F626D5022FE53BA34D5668BD698BE8D5CCAD083CBCEF440BE6A │ │ │ │ │ -8090EB1CDEE5F99C8988650BD4E539B357C31C597D8A9104A9D5967D4E906CAD │ │ │ │ │ -2A65575A884B1C5F6CC509E742FA9DDD66494F219178161AF72C50848E226A95 │ │ │ │ │ -A8C247FF9FF0BABD073021271B5C0692F9BE220071DAB09E5A026629371EE3C4 │ │ │ │ │ -A6E4FA94625D87A5B66EF077ED54C72B1052AEAA9637B30C76EF8EB04AD5F476 │ │ │ │ │ -D15F1C93C0BC6E0F67B366097BBED03FE82C040F9EF02866159B46854E11D44F │ │ │ │ │ -54AE6748A7E61B993A4EECD3B8BE3B5897A66BBCDFE24F65BC2AD5AB49048CF1 │ │ │ │ │ -647203823F84DF5CB483096F9D96AEE3A2855E479B72A14A67C633CE99C101CF │ │ │ │ │ -EFAE939BF9B02E710D │ │ │ │ │ +1B2FA10DF7E91D3BB34A1B1CE7A0015A57C813E0280D873ADB8844004ACD1870 │ │ │ │ │ +A5EA947858F5795870BFE1343AD803FB854BF8F5A4E794E8EC57BE41DB5B8734 │ │ │ │ │ +13E47950F29A81EA0C81EA798863883D7F41F78325CA190CBBFFE822AE494550 │ │ │ │ │ +4BE83703071FC9512D128927AF3F63CEF8F86ABE1E15D7B4DDD39576E7DFF45E │ │ │ │ │ +3CB4115AAB1830DE8647B915DB4BEBEB5235C281E098B899BAB951D8D5798F01 │ │ │ │ │ +7F7C47336D31438E5126738AFEAB29E9A7CBE06DE4DD604477B542D2620DFD58 │ │ │ │ │ +28FE34238572F23C5A8EB7ACEE1E154DA13FC1A5AA67A3BA8C5CDFB2B80312C9 │ │ │ │ │ +BC9FAE56D08DDFA9498E6EF0D0F6BD18B3923E0B670B0740528BC843610736CB │ │ │ │ │ +80228C105C2F72C3C22D610C3D8C268DEEA2AEEE3221E198E79FE2966487360C │ │ │ │ │ +84AE08AC326F48B21447652121B1EB68AF856055EEA65B6B625BF622CBFC2D1C │ │ │ │ │ +EF943CC4CAF2C715782C9EF9A9BA4689BFC6B6A82F8D55795BE8111E2C7DE520 │ │ │ │ │ +367362304B6A48186C842033E715A46265A352472F4F7313248EBCD26BEA97E7 │ │ │ │ │ +B814A61D4B7ADCB5C5F21AA34E0C1269E8426DBFB511DE6E26B960456C8F8520 │ │ │ │ │ +5F0DD382289A62AF0B935EDB5B2394538C5F0EE72962D2F98F3C38CD7C027B9F │ │ │ │ │ +E230E67E40FEFBDED06B3423C9DFD669E6B5BC913E0FF75786A64A6C11D4FE89 │ │ │ │ │ +1B918DC0E953C52CFD153063CD0D2A78B43F8712243845E6F2CBA1DB610F403D │ │ │ │ │ +A98D06D95FF44C7AC029092B666A8B0DCEA95B34F5ACC10E8611BADE6A24469C │ │ │ │ │ +0C01D95BFB445FA22CD38D033E4D24E006BB9D54EE41EF7AD5AC9C299721F61A │ │ │ │ │ +F01B6EDCDF428BD9195A13C5B1027358F8A203F828A1DD9622243B2D76C6F1BA │ │ │ │ │ +9F2D7E9D4879FC668ABC750CD25415DC6CCF2257C28F78D3F9BE499CC0FF2F80 │ │ │ │ │ +2C2CD1DEFABD6668FCA76E1D629A344333E33DA24B86D2E9F8F5EE1C29974640 │ │ │ │ │ +C3E78E999BAB313400041DADDDFDBFFCC419F129A84F4D412B79E8BE4511CA00 │ │ │ │ │ +F92A4F3CDD2E51345D3965C104F06B6503445DC20224CB7606A9D7D5F9EE45E6 │ │ │ │ │ +1B2963DA96AA2AB1BA5BE29656E666E4D0E122DE58EEA68E04ED76438DA03E65 │ │ │ │ │ +B80055A86B7B2A26BAE6BBB8835E17F9696E9B3CD34571BA75C76D4D2CCC48F1 │ │ │ │ │ +7534C1EF9127E374D65D05B8072E08D6C72A0B4A35EA0DD717743C66D105CCD8 │ │ │ │ │ +7355F13E9C38C1A4351624E689ED7909100942FA0474842EE44DEC3279E1A1CD │ │ │ │ │ +8064666EB845CA7C3E906B67C0BF96A28D514DB2E4A1E4AF287350B03762A2CF │ │ │ │ │ +13B18AC3F5D2F3B74A1D50267C03EFB74B888E1D24ABEEA4A885F4D0BF14C0D8 │ │ │ │ │ +289AC79D6D98E2A2C831672FB1F3457564CD161ADC3AF610D88201AB5B0C10CB │ │ │ │ │ +5ECCC2D5C4AF39C8CB3044BF9EC791BA45D29C2B51EA0483D19822C264CE6FA3 │ │ │ │ │ +5C97F2DF5A78CB93528E99B9ED7CB121C83130C129B849B52A36EBD88AF19DD3 │ │ │ │ │ +C5CABE831027388EF86BD5CBD90AAAC089775938A321C44D4DDA67A51312D8AB │ │ │ │ │ +C509DDBE7044A107AB2BE9C4C9556F85C529B174A7778B489BF28EC07A834542 │ │ │ │ │ +8B31F2925C21FB2096877711F998763D5A8495002B8E080AF8DBB1B3106EDDBA │ │ │ │ │ +35121D52E0846A7AF3ABEDF87BDE4FA665673A9B80CA538B98F873947AA17EF4 │ │ │ │ │ +9BB182917E9D79BC7EC681E93710D6A1D6B0E4A7FA9452FC1C431808174F3AB7 │ │ │ │ │ +F3914FBC86CB34E8583457243C3C7BE4BC166C7397689BC6FFB82EA2967E88EE │ │ │ │ │ +464F96EDA144DE2B64401B8E577ABCA2D826FE0B92E21FFAE3E81EBB6B6EB36E │ │ │ │ │ +9B1A8FE3884CA398C03135FD49D51724FC1268E9482E41FAEA2FC6C809006B8F │ │ │ │ │ +5D4F9E038450AD3A6041C16FD1C7E5FC80C0E033CE57E64863E014531D94DF1E │ │ │ │ │ +31D7D038AFCB60715AA73C1E96F113A24C5AF35BBEB61C4D079ED034ED83AA4A │ │ │ │ │ +E12448E618330463304788BCF40561CD63167B3BF144F408E2B89E60B8BA13EF │ │ │ │ │ +3B57D286FD23D4FA8BAEFF98DC1188B1982956CC1DCAEFC7D949B7B4E3BE8F8A │ │ │ │ │ +BFE2C9D938DD13EFEE7123576608D9396F260907DA98AE2D3DD5822306CBC8A6 │ │ │ │ │ +B083C697DDA3C62EE7879436A9FD8EE0034B105105B3F122F893EA2126EBE8A9 │ │ │ │ │ +5CBF2BD248DD9FBEF0040C25797BD13B69A8C9F0D4E4F935C61ED30487CCDB1A │ │ │ │ │ +0339006E78EE1755929D2412776EC7DB1F666DBDD28EA8AC7397F809C7F38A41 │ │ │ │ │ +5B3BF6C75F4F35C90141EB08377AF452CF840FEA938805F9D14E02DC29215B4E │ │ │ │ │ +F1EB │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ 0000000000000000000000000000000000000000000000000000000000000000 │ │ │ │ │ @@ -5618,16 +5609,16 @@ │ │ │ │ │ FFFFFFC0FFFFFFFFC07FFFFFFF807FFFFFFF807FFFFFFF803FFFFFFF003FFFFFFF001FFF │ │ │ │ │ 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 │ │ │ │ │ -23[45 19[83 18[25 2[45 2[45 1[45 45 45 3[25 44[{}10 90.9091 │ │ │ │ │ +68 2[71 2[25 25 58[{}15 90.9091 /CMMI10 rf /Fh 138[51 │ │ │ │ │ +6[51 8[40 26[47 15[25 4[45 2[45 1[45 3[25 44[{}9 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 │ │ │ │ │ @@ -5703,17 +5694,17 @@ │ │ │ │ │ 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 1203 4 v │ │ │ │ │ -1385 w Fl(Misc)29 b Fh(:)41 b Fj(DRAFT)30 b Fh(Ma)m(y)h(17,)h(2024)p │ │ │ │ │ -2698 100 V 111 399 a Fp(2.)46 b Fl(void)h(mkNDperm2)e(\()j(int)f(n1,)f │ │ │ │ │ +TeXDict begin 2 1 bop 0 100 a Fp(2)p 136 100 1196 4 v │ │ │ │ │ +1378 w Fl(Misc)29 b Fh(:)41 b Fj(DRAFT)30 b Fh(June)f(20,)j(2025)p │ │ │ │ │ +2704 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 │ │ │ │ │ @@ -5800,17 +5791,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 1203 4 v 1384 100 a Fl(Misc)29 │ │ │ │ │ -b Fh(:)41 b Fj(DRAFT)121 b Fh(Ma)m(y)32 b(17,)f(2024)p │ │ │ │ │ -2650 100 V 1203 w Fp(3)111 399 y(5.)46 b Fl(void)h(fp2DGrid)e(\()j(int) │ │ │ │ │ +TeXDict begin 3 2 bop 91 100 1196 4 v 1377 100 a Fl(Misc)30 │ │ │ │ │ +b Fh(:)40 b Fj(DRAFT)121 b Fh(June)30 b(20,)h(2025)p │ │ │ │ │ +2657 100 V 1196 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) │ │ │ │ │ @@ -5882,17 +5873,17 @@ │ │ │ │ │ (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 1203 4 v │ │ │ │ │ -1385 w Fl(Misc)29 b Fh(:)41 b Fj(DRAFT)30 b Fh(Ma)m(y)h(17,)h(2024)p │ │ │ │ │ -2698 100 V 111 399 a Fp(2.)46 b Fl(ETree)h(*)g(orderViaND)e(\()j(Graph) │ │ │ │ │ +TeXDict begin 4 3 bop 0 100 a Fp(4)p 136 100 1196 4 v │ │ │ │ │ +1378 w Fl(Misc)29 b Fh(:)41 b Fj(DRAFT)30 b Fh(June)f(20,)j(2025)p │ │ │ │ │ +2704 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 │ │ │ │ │ @@ -5970,17 +5961,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 1203 4 v 1384 100 a Fl(Misc)29 │ │ │ │ │ -b Fh(:)41 b Fj(DRAFT)121 b Fh(Ma)m(y)32 b(17,)f(2024)p │ │ │ │ │ -2650 100 V 1203 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 1196 4 v 1377 100 a Fl(Misc)30 │ │ │ │ │ +b Fh(:)40 b Fj(DRAFT)121 b Fh(June)30 b(20,)h(2025)p │ │ │ │ │ +2657 100 V 1196 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 │ │ │ │ │ @@ -6063,17 +6054,17 @@ │ │ │ │ │ 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 1203 4 v │ │ │ │ │ -1385 w Fl(Misc)29 b Fh(:)41 b Fj(DRAFT)30 b Fh(Ma)m(y)h(17,)h(2024)p │ │ │ │ │ -2698 100 V 227 399 a Fp(is)41 b(ordered)f(using)h(theoretical)i(nested) │ │ │ │ │ +TeXDict begin 6 5 bop 0 100 a Fp(6)p 136 100 1196 4 v │ │ │ │ │ +1378 w Fl(Misc)29 b Fh(:)41 b Fj(DRAFT)30 b Fh(June)f(20,)j(2025)p │ │ │ │ │ +2704 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 │ │ │ │ │ @@ -6140,17 +6131,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 1203 4 v 1384 100 a Fl(Misc)29 │ │ │ │ │ -b Fh(:)41 b Fj(DRAFT)121 b Fh(Ma)m(y)32 b(17,)f(2024)p │ │ │ │ │ -2650 100 V 1203 w Fp(7)111 399 y(3.)46 b Fl(testOrderViaND)e(msglvl)i │ │ │ │ │ +TeXDict begin 7 6 bop 91 100 1196 4 v 1377 100 a Fl(Misc)30 │ │ │ │ │ +b Fh(:)40 b Fj(DRAFT)121 b Fh(June)30 b(20,)h(2025)p │ │ │ │ │ +2657 100 V 1196 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 │ │ │ │ │ @@ -6220,17 +6211,17 @@ │ │ │ │ │ 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 1203 4 v │ │ │ │ │ -1385 w Fl(Misc)29 b Fh(:)41 b Fj(DRAFT)30 b Fh(Ma)m(y)h(17,)h(2024)p │ │ │ │ │ -2698 100 V 227 399 a Fp(This)41 b(driv)m(er)g(program)h(generates)h(a)f │ │ │ │ │ +TeXDict begin 8 7 bop 0 100 a Fp(8)p 136 100 1196 4 v │ │ │ │ │ +1378 w Fl(Misc)29 b Fh(:)41 b Fj(DRAFT)30 b Fh(June)f(20,)j(2025)p │ │ │ │ │ +2704 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 │ │ │ │ │ @@ -6306,17 +6297,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 1203 4 v 1384 100 a Fl(Misc)29 │ │ │ │ │ -b Fh(:)41 b Fj(DRAFT)121 b Fh(Ma)m(y)32 b(17,)f(2024)p │ │ │ │ │ -2650 100 V 1203 w Fp(9)1541 1617 y(Figure)g(1.1:)42 b │ │ │ │ │ +TeXDict begin 9 8 bop 91 100 1196 4 v 1377 100 a Fl(Misc)30 │ │ │ │ │ +b Fh(:)40 b Fj(DRAFT)121 b Fh(June)30 b(20,)h(2025)p │ │ │ │ │ +2657 100 V 1196 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 │ │ │ │ │ @@ -6721,17 +6712,17 @@ │ │ │ │ │ 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 1180 4 │ │ │ │ │ -v 1362 w Fl(Misc)30 b Fh(:)40 b Fj(DRAFT)31 b Fh(Ma)m(y)g(17,)h(2024)p │ │ │ │ │ -2720 100 V 813 1617 a Fp(Figure)e(1.2:)42 b Fb(R2D100:)k(fishnet)33 │ │ │ │ │ +TeXDict begin 10 9 bop 0 100 a Fp(10)p 182 100 1173 4 │ │ │ │ │ +v 1356 w Fl(Misc)29 b Fh(:)40 b Fj(DRAFT)31 b Fh(June)e(20,)i(2025)p │ │ │ │ │ +2727 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 │ │ │ │ │ @@ -7140,17 +7131,17 @@ │ │ │ │ │ 348.123 444.374 (0) radius drawLabel │ │ │ │ │ grestore │ │ │ │ │ showpage │ │ │ │ │ │ │ │ │ │ %%EndDocument │ │ │ │ │ @endspecial eop end │ │ │ │ │ %%Page: 11 11 │ │ │ │ │ -TeXDict begin 11 10 bop 91 100 1180 4 v 1362 100 a Fl(Misc)29 │ │ │ │ │ -b Fh(:)40 b Fj(DRAFT)122 b Fh(Ma)m(y)31 b(17,)h(2024)p │ │ │ │ │ -2628 100 V 1180 w Fp(11)227 399 y Fg(A)f Fp(is)f(factored)h(as)1106 │ │ │ │ │ +TeXDict begin 11 10 bop 91 100 1173 4 v 1355 100 a Fl(Misc)29 │ │ │ │ │ +b Fh(:)40 b Fj(DRAFT)122 b Fh(June)29 b(20,)i(2025)p │ │ │ │ │ +2634 100 V 1173 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 │ │ │ │ │ @@ -7259,17 +7250,17 @@ │ │ │ │ │ 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 1180 │ │ │ │ │ -4 v 1362 w Fl(Misc)30 b Fh(:)40 b Fj(DRAFT)31 b Fh(Ma)m(y)g(17,)h(2024) │ │ │ │ │ -p 2720 100 V 337 399 a Ff(\210)45 b Fp(The)29 b Fl(ETreeFile)e │ │ │ │ │ +TeXDict begin 12 11 bop 0 100 a Fp(12)p 182 100 1173 │ │ │ │ │ +4 v 1356 w Fl(Misc)29 b Fh(:)40 b Fj(DRAFT)31 b Fh(June)e(20,)i(2025)p │ │ │ │ │ +2727 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 │ │ │ │ │ @@ -7337,17 +7328,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 1180 4 v 1362 100 a Fl(Misc)29 │ │ │ │ │ -b Fh(:)40 b Fj(DRAFT)122 b Fh(Ma)m(y)31 b(17,)h(2024)p │ │ │ │ │ -2628 100 V 1180 w Fp(13)427 399 y Fl(nrow)47 b(ncol)g(nent)427 │ │ │ │ │ +TeXDict begin 13 12 bop 91 100 1173 4 v 1355 100 a Fl(Misc)29 │ │ │ │ │ +b Fh(:)40 b Fj(DRAFT)122 b Fh(June)29 b(20,)i(2025)p │ │ │ │ │ +2634 100 V 1173 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) │ │ │ │ │ @@ -7403,17 +7394,17 @@ │ │ │ │ │ (\(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 1180 │ │ │ │ │ -4 v 1362 w Fl(Misc)30 b Fh(:)40 b Fj(DRAFT)31 b Fh(Ma)m(y)g(17,)h(2024) │ │ │ │ │ -p 2720 100 V 427 399 a Fp(for)e Fg(A)h Fp(real)g(or)f(complex)h │ │ │ │ │ +TeXDict begin 14 13 bop 0 100 a Fp(14)p 182 100 1173 │ │ │ │ │ +4 v 1356 w Fl(Misc)29 b Fh(:)40 b Fj(DRAFT)31 b Fh(June)e(20,)i(2025)p │ │ │ │ │ +2727 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 │ │ │ │ │ @@ -7474,17 +7465,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 1180 4 v 1362 100 a Fl(Misc)29 │ │ │ │ │ -b Fh(:)40 b Fj(DRAFT)122 b Fh(Ma)m(y)31 b(17,)h(2024)p │ │ │ │ │ -2628 100 V 1180 w Fp(15)337 399 y Ff(\210)45 b Fl(type)29 │ │ │ │ │ +TeXDict begin 15 14 bop 91 100 1173 4 v 1355 100 a Fl(Misc)29 │ │ │ │ │ +b Fh(:)40 b Fj(DRAFT)122 b Fh(June)29 b(20,)i(2025)p │ │ │ │ │ +2634 100 V 1173 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 May 17, 2024 │ │ │ │ │ │ + 2 Misc : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 3 │ │ │ │ │ │ + Misc : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 4 Misc : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 5 │ │ │ │ │ │ + Misc : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 6 Misc : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 7 │ │ │ │ │ │ + Misc : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 8 Misc : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 9 │ │ │ │ │ │ + Misc : DRAFT June 20, 2025 9 │ │ │ │ │ │ Figure 1.1: R2D100 │ │ │ │ │ │ - 10 Misc : DRAFT May 17, 2024 │ │ │ │ │ │ - Figure 1.2: R2D100: fishnet domain decomposition │ │ │ │ │ │ - 3 3 3 3 3 3 3 0 0 5 │ │ │ │ │ │ - 3 │ │ │ │ │ │ - 3 3 3 0 0 │ │ │ │ │ │ - 3 3 │ │ │ │ │ │ - 3 1 │ │ │ │ │ │ - 0 0 1 1 │ │ │ │ │ │ - 3 0 1 │ │ │ │ │ │ - 3 1 │ │ │ │ │ │ - 0 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 │ │ │ │ │ │ - 1 1 │ │ │ │ │ │ - 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 May 17, 2024 11 │ │ │ │ │ │ + 10 Misc : DRAFT June 20, 2025 │ │ │ │ │ │ + Figure 1.2: R2D100: fishnet domain decomposition │ │ │ │ │ │ + 3 3 3 3 3 3 3 0 0 5 │ │ │ │ │ │ + 3 │ │ │ │ │ │ + 3 3 3 0 0 │ │ │ │ │ │ + 3 3 │ │ │ │ │ │ + 3 1 │ │ │ │ │ │ + 0 0 1 1 │ │ │ │ │ │ + 3 0 1 │ │ │ │ │ │ + 3 1 │ │ │ │ │ │ + 0 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 │ │ │ │ │ │ + 1 1 │ │ │ │ │ │ + 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 June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 12 Misc : DRAFT June 20, 2025 │ │ │ │ │ │ • 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 May 17, 2024 13 │ │ │ │ │ │ + Misc : DRAFT June 20, 2025 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 May 17, 2024 │ │ │ │ │ │ + 14 Misc : DRAFT June 20, 2025 │ │ │ │ │ │ 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 May 17, 2024 15 │ │ │ │ │ │ + Misc : DRAFT June 20, 2025 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 │ │ │ │ │ │ ... │ │ ├── xz --list │ │ │ @@ -1,13 +1,13 @@ │ │ │ Streams: 1 │ │ │ Blocks: 1 │ │ │ - Compressed size: 6609.9 KiB (6768500 B) │ │ │ - Uncompressed size: 6880.0 KiB (7045120 B) │ │ │ + Compressed size: 6592.4 KiB (6750668 B) │ │ │ + Uncompressed size: 6860.0 KiB (7024640 B) │ │ │ Ratio: 0.961 │ │ │ Check: CRC64 │ │ │ Stream Padding: 0 B │ │ │ Streams: │ │ │ Stream Blocks CompOffset UncompOffset CompSize UncompSize Ratio Check Padding │ │ │ - 1 1 0 0 6768500 7045120 0.961 CRC64 0 │ │ │ + 1 1 0 0 6750668 7024640 0.961 CRC64 0 │ │ │ Blocks: │ │ │ Stream Block CompOffset UncompOffset TotalSize UncompSize Ratio Check │ │ │ - 1 1 12 0 6768460 7045120 0.961 CRC64 │ │ │ + 1 1 12 0 6750628 7024640 0.961 CRC64