KATIE(1)                      The Regina Handbook                     KATIE(1)



<?><?><?> (NAME)
       katie - <?><?><?><?><?><?><?><?><?> <?><?> <?>-<?><?><?><?><?> <?><?>
       <?>-<?><?><?><?><?> <?><?> <?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?>

<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       katie pd_code framing_vector [ -3, --dim3 | -4, --dim4 ] [ -g, --graph
       ] [ -V, --verbose ]


       katie { -v, --version | -?, --help }


<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?> <?><?> <?><?> <?>-<?><?><?><?><?> <?><?>
       <?>-<?><?><?><?><?> <?><?> <?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> <?><?><?><?><?><?><?>.

       <?><?><?><?> <?>-<?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?> <?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       (Dehn surgery) <?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?>.

       <?><?><?><?> <?>-<?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?> <?> <?> <?><?><?><?><?><?><?><?><?> <?><?>
       <?><?><?> <?>-<?><?><?><?><?> <?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> (<?><?>
       <?><?><?><?><?>) <?><?> <?><?><?> <?><?><?><?><?><?>.

       <?><?><?><?><?> Katie <?><?> <?><?><?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?>:
       <?><?><?><?><?> <?><?><?><?><?><?><?> (<?><?><?><?> <?><?><?><?><?>)<?>
       <?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?><?> <?><?> <?><?> <?><?><?> <?><?><?><?><?><?><?>
       (<?><?><?><?><?> <?><?><?><?><?><?><?><?> <?>/<?><?>
       <<<?><?><?><?><?><?><?><?><?>>> <?><?><?><?><?> <?>).

       o <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?> <?><?>
         <?><?><?><?><?><?><?> <?><?><?><?> (PD) <?><?><?><?><?> <?><?><?><?>
         <?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?> <?><?>
         <?><?><?><?> SnapPy <?><?> <?><?><?> <?><?><?><?><?><?>.
         <?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?>
         <?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?>
         <?><?><?><?><?><?><?><?> PLink <?><?><?><?><?><?><?> SnapPy <?>
         <?><?><?> <?><?><?><?> <?><?> PD <?><?><?><?><?><?><?><?>
         <?><?><?><?> SnapPy <?><?> <?><?><?><?> <?><?><?><?><?><?>
         <?><?><?><?> InfoPD Code <?><?> <?><?><?><?><?><?><?><?> <?><?><?>.

       o <?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?>
         <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?> <?> <?><?> 'x'
         <?><?> '.' <?><?><?><?><?><?><?> <?><?><?><?>.

         <?><?><?><?><?>: <?><?> PD <?> <?><?><?><?><?><?><?>
         <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?> <?><?>
         <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?>.
         <?><?><?> Katie <?><?> <?><?> <?><?><?><?> <?><?> <?><?> <?><?><?><?>
         <?><?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?> <?><?><?>
         <?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
         <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
         <?><?><?><?>.

       <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?> Katie <?><?> <?><?> <?><?>
       <?><?><?><?><?> <https://raburke.github.io> <?><?> <?><?><?><?><?>
       <?><?><?> <?><?><?><?><?><?>.

<?><?><?><?><?><?><?><?> (OPTIONS)
       -3, --dim3
              <?><?><?><?> <?>-<?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
              <?><?><?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?>
              <?><?><?><?><?>.

              <?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?>
              --dim3 <?><?> --dim4 <?><?> <?><?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?>
              <?>-<?><?><?><?><?> <?><?><?>.

       -4, --dim4
              <?><?><?><?> <?>-<?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?> <?> <?> <?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
              <?><?> <?><?><?> <?>-<?><?><?><?><?>.

              <?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?>
              <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?> --dim3
              <?><?> --dim4 <?><?> <?><?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?>.

       -g, --graph
              <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?> <?><?> <?><?><?><?><?>. <?><?> <?><?><?>
              <?><?><?><?> <?><?> <?><?><?><?> <?>-<?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?><?><?><?>
              (tetrahedron) <?> <?><?> <?><?><?><?>
              <?>-<?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?>
              <?><?><?><?><?><?><?><?> (pentachoron) <?><?><?>. <?><?>
              <?><?><?> <?><?><?><?> <?><?> <?><?><?> <?><?> <?><?><?> c
              <?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?>
              <?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?>
              <?><?><?> <?><?><?><?><?><?> <?><?>
              <?><?><?><?><?><?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?>
              <?><?><?><?><?> c <?><?> <?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?> <?><?><?><?><?>.

       -V, --verbose
              <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?> <?><?><?>
              <?><?><?><?><?><?> <?><?><?><?>.

       -v, --version
              <?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?> <?><?> Regina <?> <?><?><?><?>
              <?><?><?><?>.

       -?, --help
              <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?>
              <?><?><?><?> <?><?><?><?>.

<?><?><?><?><?><?><?> (EXAMPLES)
       <?><?><?><?><?> <?><?><?> <?>-<?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?> <?><?><?><?><?> <?>+
       <?><?> <?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?>.

           example$ katie "[(6,4,1,3),(4,2,5,1),(2,6,3,5)]" "1" -3
           Writhes:
           Component 0: 2-handle, writhe 1

           Here is the isomorphism signature:
           GLvvQvPvALvzMAQAvAQQQPccgfekjp...
           example$

       <?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?> <?> <?><?> <?><?><?> <?>-<?><?><?><?><?>
       <?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?><?> <?>+ <?><?><?><?><?><?><?>.

           example$ katie "[(1,1,2,2)]" "1"
           Writhes:
           Component 0: 2-handle, writhe 1

           Here is the isomorphism signature:
           mLvAwAQAPQQcfffhijgjgjkkklklll...
           example$

       <?><?><?><?><?> <?><?><?> <?><?> <?>-<?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?> <?><?> <?><?><?><?><?>
       <?> <?> <?> <?><?><?>.

           example$ katie "[(4,8,1,9),(9,3,10,4),(1,5,2,6),(6,2,7,3),(7,5,8,10)]" "x 0"
           Writhes:
           Component 0: 1-handle (0)
           Component 1: 2-handle, writhe 0

           Here is the isomorphism signature:
           SLvAvAAwvvALMQQPvPvPMQwQAQMAvQ...
           example$

<?><?><?><?><?><?><?> <?><?><?><?><?><?><?> (MACOS USERS)
       <?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?> <?><?><?> <?><?><?><?> (drag-and-drop app bundle)
       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?> <?><?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?>.
       <?><?><?> Regina <?><?> <?><?> <?><?><?><?><?> <?><?><?><?>
       Applications <?><?><?><?><?> <?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?> <?><?> <?><?> <?><?><?><?>
       /Applications/Regina.app/Contents/MacOS/katie <?><?><?><?>
       <?><?><?><?>.

<?><?><?><?><?><?><?> <?><?><?><?><?><?> (WINDOWS USERS)
       <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?> <?><?><?>
       <?><?><?><?><?><?><?><?><?> Program Files <?><?><?>
       <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?><?>
       Program Files (x86) <?><?><?><?><?><?> <?><?><?><?><?><?>.
       <?><?><?><?><?><?><?><?><?> <?><?><?> <?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?><?> c:\Program Files\Regina\Regina 7.4.1\bin\katie.exe
       <?><?><?><?> <?><?><?><?>.

<?><?><?><?><?><?><?><?><?> (AUTHORS)
       <?><?><?> <?><?><?><?><?> <?><?><?><?> Rhuaidi Burke
       <rhuaidi.burke@uq.edu.au> <?><?><?><?><?> <?><?><?> <?><?><?>.
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> Regina
       <?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?>.

                                25 August 2025                        KATIE(1)