.. _guimath:

GUIMath
-------



.. class:: GUIMath


    Syntax:
        ``obj = h.GUIMath()``


    Description:
        Contains functions which calculate common relationships between graphics 
        objects. 

         

----



.. method:: GUIMath.d2line


    Syntax:
        ``d = guimath.d2line(xpoint, ypoint, xline0, yline0, xline1, yline1)``


    Description:
        Return distance between the point (xpoint,ypoint) and the (infinitely long) 
        line defined by the 0 and 1 points. 

         

----



.. method:: GUIMath.d2line_seg


    Syntax:
        ``d = guimath.d2line_seg(xpoint, ypoint, xline0, yline0, xline1, yline1)``


    Description:
        Return distance between the point (xpoint, ypoint) and the line segment 
        line defined by the 0 and 1 points. 

         

----



.. method:: GUIMath.inside


    Syntax:
        ``boolean = guimath.inside(xpoint, ypoint, left, bottom, right, top)``


    Description:
        return True if the point is inside the box, False otherwise 

         

----



.. method:: GUIMath.feround


    Syntax:
        ``mode = guimath.feround()``

        ``lastmode = guimath.feround(mode)``


    Description:
        Set the floating point rounding mode. Mode 1, 2, 3, 4 refers to 
        FE_DOWNWARD, FE_TONEAREST, FE_TOWARDZERO, FE_UPWARD respectively. 
        The default, and most accurate, mode is FE_TONEAREST. 
        The mode is changed only if the argument is 1-4. If there is no 
        support for this function the return value is 0. 
         
        This function is useful to determine if a simulation depends unduly 
        on double precision round-off error.

        This affects calculations performed in both Python and HOC. 

    Example:

        .. code::

            from neuron import h

            gm = h.GUIMath()
            print('default rounding mode %d' % gm.feround())

            def test_round(mode):
                gm = h.GUIMath()
                old = gm.feround(mode)
                x = 0
                for i in range(1, 1000001):
                    x += 0.1
                print('round mode %d x=%25.17lf' % (mode, x))
                gm.feround(old)

            for i in range(1, 5):
                test_round(i)

        Output:

            .. code-block::
                none

                default rounding mode 2
                round mode 1 x=  99999.99999613071850035
                round mode 2 x= 100000.00000133288267534
                round mode 3 x=  99999.99999613071850035
                round mode 4 x= 100000.00000432481465396