NAME

       regina-gui - Regina's graphical user interface

SYNOPSIS

       regina-gui [ file ... ]

DESCRIPTION

       Regina  is  a  software  package  for  studying 3-manifold triangulations and normal surfaces.  Other key
       features include angle structures, census enumeration, combinatorial recognition of  triangulations,  and
       high-level  tasks such as 3-sphere recognition and connected sum decomposition.  Regina comes with a full
       graphical user interface, and also offers Python bindings and a low-level C++ programming interface.

       This starts the full graphical user interface, and is the usual way of starting Regina.  Any files passed
       on the command-line will be opened on startup.

ENVIRONMENT VARIABLES

       The following environment variables influence the behaviour of this program.

       REGINA_PYLIBDIR
              The directory containing the Python module regina.

              If you have installed Regina's Python module in a  standard  Python  location  (i.e.,  Python  can
              import  it  directly  without  extending  sys.path),  then REGINA_PYLIBDIR should be left empty or
              undefined.

              Normally you should not need to set this option yourself.  This program should know  how  to  find
              Regina's Python module in standard situations, which include fixed filesystem installations (e.g.,
              GNU/Linux  and  Windows),  relocatable  app  bundles  (e.g., macOS), and running directly from the
              source tree.

       REGINA_HOME
              The directory beneath which Regina's data files  are  installed.   These  include  (amongst  other
              things)  example  files in $REGINA_HOME/examples/, API documentation in $REGINA_HOME/engine-docs/,
              and census databases in $REGINA_HOME/data/census/.

              Normally you should not need to set this option yourself.  This program should know  how  to  find
              its  data  files  in  standard  situations,  which  include  fixed filesystem installations (e.g.,
              GNU/Linux and Windows), relocatable app bundles (e.g.,  macOS),  and  running  directly  from  the
              source tree.

MACOS USERS

       If  you  downloaded  a  drag-and-drop  app  bundle,  this is the program that runs when you open it.  The
       executable itself is simply called Regina, not regina-gui.

SEE ALSO

       regina-python.

       Regina comes with a rich users' handbook, which you can access via Help->Regina  Handbook  in  the  menu.
       You can also read the users' handbook online at http://regina-normal.github.io/docs/.

AUTHOR

       Many  people  have been involved in the development of Regina; see the users' handbook for a full list of
       credits.

                                                17 December 2021                                   REGINA-GUI(1)