Skip to content

Latest commit

 

History

History
executable file
·
127 lines (66 loc) · 2.53 KB

guimath.rst

File metadata and controls

executable file
·
127 lines (66 loc) · 2.53 KB

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