Fung-Calc"> ]> The &fungcalc; Handbook 2003-06-06 0.00.02 Jason Kivlighn
mizunoami44@users.sourceforge.net
2003 Jason Kivlighn &FDLNotice; The &fungcalc; is an advanced, yet easy to use graphing calculator for Linux that supports graphing in both 2D and 3D. Several different plot types are available and graphs can be animated. This document is at the moment incomplete, but is here to show that a complete documentation is underway. KDE plotter graphing plotting polar expression function 3D spherical cylindrical animation
&fungcalc-introduction; &fungcalc-installation; Getting Started The &fungcalc; was written to be especially easy to use. For the most part, one should be able launch the program and begin to graph without even reading any documentation. Launch the program by typing fung-calc. Click on the New icon and a New Graph dialog will be presented. New Graph Dialog New Graph Dialog Select one of the many graphing options and click OK. Specifics about each graphing mode can be found in . A graph window will appear and you are ready to go. Graphing Modes The &fungcalc; offers various graphing modes. These include several 2- and 3-dimensional graphing modes, as well as a stat plot mode which can represent data as a box-and-whisker, frequency distribution, or scatter plot. 2-Dimensional Graphing The &fungcalc; offers the following 2-dimensional graphing modes. Function Graph Graph graphs explicit expressions on a plane using a vertical y-axis and horizontal x-axis. This graphically displays how the values of the dependent variable, y, varies with the independent variable, x. Function Graph Window Function Graph Window Enter an expression into the combo box directly below the graph display. The variable used in the expression is x and the n variable can be used for animating graphs (See for information on animating graphs). For more information on understood expressions, see . Add the entered expression to the graph by either hitting enter while the expression combo box is active or by clicking the Graph button. To add another expression the the same graph, select the combo box item: [New Expression]. The combo box will display an empty line in which the user can enter an expression. Revisit previously entered expressions by selecting them from the combo box. The color of this expression can be chosen by clicking the color button directly left of the graph and selecting a color from the displayed color dialog. The color does not take affect until the expression is added to the graph. Deselect the checkbox to the left of the color button to temporarily hide the current expression. Remove the current expression by clicking the Remove button. Previously entered expressions, if any, will be renumbered accordingly. Function Graph Controls Polar Graph Polar Graph Controls Parametric Graph Parametric Graph Controls Density Plot Density Plot Controls 3-Dimensional Graphing The &fungcalc; offers the following 3-dimensional graphing modes. 3D Function Graph 3D Function Graph Controls Spherical Graph Spherical Graph Controls Cylindrical Graph Cylindrical Graph Controls Stat Plot intro stat Box-and-Whisker Frequency Distribution Scatter Plot Understood Expressions The &fungcalc; recognizes several functions, operators, and constants. Following is a complete description of each of these. Operators Expressions can be created using the following operators, evaluated in this order of precedence: ( ) expressions in parentheses first -A unary minus A^B exponentiation (A raised to the power B) A*B A/B A%B multiplication, division and modulo A+B A-B addition and subtraction A=B A<B A>B comparison between A and B (result is either 0 or 1) Note that the '=' comparison can be inaccurate due to floating point precision problems (eg. "sqrt(100)=10" probably returns 0, not 1). A&B result is 1 if int(A) and int(B) differ from 0, else 0. A|B result is 1 if int(A) or int(B) differ from 0, else 0. Functions The class supports these functions: abs(A) Absolute value of A. If A is negative, returns -A otherwise returns A. acos(A) Arc-cosine of A. Returns the angle whose cosine is A. acosh(A) Same as acos() but for hyperbolic cosine. asin(A) Arc-sine of A. Returns the angle whose sine is A. asinh(A) Same as asin() but for hyperbolic sine. atan(A) Arc-tangent of (A). Returns the angle whose tangent is (A). atan2(A,B) Arc-tangent of A/B. The two main differences to atan() is that it will return the right angle depending on the signs of A and B (atan() can only return values betwen -pi/2 and pi/2), and that the return value of pi/2 and -pi/2 are possible. atanh(A) Same as atan() but for hyperbolic tangent. ceil(A) Ceiling of A. Returns the smallest integer greater than A. Rounds up to the next higher integer. cos(A) Cosine of A. Returns the cosine of the angle A. cosh(A) Same as cos() but for hyperbolic cosine. cot(A) Cotangent of A (equivalent to 1/tan(A)). csc(A) Cosecant of A (equivalent to 1/sin(A)). exp(A) Exponential of A. Returns the value of e raised to the power A where e is the base of the natural logarithm, i.e. the non-repeating value approximately equal to 2.71828182846. floor(A) Floor of A. Returns the largest integer less than A. Rounds down to the next lower integer. if(A,B,C) If int(A) differs from 0, the return value of this function is B, else C. Only the parameter which needs to be evaluated is evaluated, the other parameter is skipped. int(A) Rounds A to the closest integer. 0.5 is rounded to 1. log(A) Natural (base e) logarithm of A. log10(A) Base 10 logarithm of A. max(A,B) If A>B, the result is A, else B. min(A,B) If A<B, the result is A, else B. sec(A) Secant of A (equivalent to 1/cos(A)). sin(A) Sine of A. Returns the sine of the angle A. sinh(A) Same as sin() but for hyperbolic sine. sqrt(A) Square root of A. Returns the value whose square is A. tan(A) Tangent of A. Returns the tangent of the angle A. tanh(A) Same as tan() but for hyperbolic tangent. Constants Constants that are recognized include: e (Euler's Constant) 2.718281828 pi 3.14159265358979323 Animation This chapter applies to all graphing modes with the exception of the stat plot, which cannot be animated. Animation works by taking the variable, n, steadily increasing it, and displaying the new graph at the current n-value. Any equation can be made into an animation by adding an extra variable, n, to the expression. The slider in the Animation Toolbar controls the value for n. Alternately, use the Play button included in the Animation Toolbar to repeatedly through loop values of n. Qt's slider is only able to increment whole numbers. A workaround is possible and in the works. Animation Toolbar Animation Toolbar Animation Toolbar Play Begin infinitely looping through values of n, and updating the graph accordingly after each step. Pause Pauses the animation, leaving the value of n at its current value. Stop Stops the animating of the graph and resets the value of n to the minimum value. Animation Parameters Dialog Animation Parameters Dialog Animation Parameters Dialog This dialog contains several parameters for customizing the behavior of an animation. NMin This is the value of n that the animation begins at and resets to after every complete cycle. NMax This is the value of n at which n no longer increases. At this point, the animation value will begin back at the value of NMin. NStep Controls the increase applied to n after each frame of animation. The smaller the value, the smoother the animation is. Speed Controls the speed of the animation in milliseconds (1000 milliseconds = 1 second). This is the amount of time between each new frame in the animation. Math Functions These are several different functions that provide various information about an expression on a graph and display it to the user, such distance between two points, definite integral, etc. This lists which graph modes provide each function, as well as their purpose or meaning. Distance Available on the following graph(s): Function Graph, Polar Graph, Parametric Graph, Density Plot, and Stat Plot. Will ask the user to select two points on the graph. The distance between these two points will be returned and displayed at the lower left of the graph display. Minimum Available on the following graph(s): Function Graph. Will ask the user to select two points on the graph on the current expression. The minimum value on this interval will be displayed at the lower left of the graph display. Maximum Available on the following graph(s): Function Graph. Will ask the user to select two points on the graph on the current expression. The maximum value on this interval will be displayed at the lower left of the graph display. Definite Integral Available on the following graph(s): Function Graph. Will ask the user to select two points on the graph on the current expression. The definite integral on this interval will be displayed at the lower left of the graph display. The definite integral on an interval is the area underneath the points selected. This area will be shaded. Arc Length Available on the following graph(s): Function Graph and Parametric Graph. Will ask the user to select two points on the graph on the current expression. The arc length on this interval will be displayed at the lower left of the graph display. Mean Value Available on the following graph(s): Function Graph. Will ask the user to select two points on the graph on the current expression. The mean value on this interval will be displayed at the lower left of the graph display. The mean value on an interval is the point at which the slope of a line tangent to the graph is equal to the slope of the two points selected. This tangent line will be drawn to express this. The Controls The controls are the buttons and text boxes beneath every graph window which offer a convenient way to control several aspects of the graph view, as well as certain options, for a graph display. If these controls get in the way, hide them simply by clicking on the Controls << button beneath the graph display. See to find out about which controls are available for each graphing mode. The Menubar This provides a brief description of all menu items available via the menu bar. File File New Displays a new graph dialog which contains several graph types to choose from. File Open Open a file created by the &fungcalc; when drawing the graph File Save... Saves only the active graph in a format specific to the &fungcalc;. File Save All... Saves all graphs opened to a single file in a format specific to the &fungcalc;. File Export Export as DXF... Exports a graph to the Drawing Exchange File Format. This can then be read and edited by an application such as AutoCAD or any program which supports the DXF file format. File Export Export as Image... Export the graph to one of several image types such as PNG, JPG, XPM, and BMP. File Print... Displays a KDE print dialog to print the current graph display. File Exit Exits the application immediately. Graphs currently opened are lost. View View Scale Hides or shows the scale when drawing the graph. These are the numbers along the top and left of the screen, labeling the values along the x and y axis. View Grid Hides or shows the grid when drawing the graph View Axis Hides or shows the axis when drawing the graph Options Options Snap to Grid Wheter or not to snap the current position of the mouse over the graph to an interval along the grid. Combine this with trace to determine values of a function at an exact point along the grid. Options Trace Whether or not to activate the trace feature of a graph. While tracing, a box will be displayed at the position of the graph which the mouse cooresponds to. The values of the independent and dependent variables will at this point will be displayed in the status bar. Options Draw Connected Whether or not to connect subsequent points on a graph while plotting expressions. Options Colors Axis Set the color of the axis on a graph. A Qt color dialog will displayed. Options Colors Grid Set the color of the grid on a graph. A Qt color dialog will displayed. Options Colors Background Set the background color of the graph display. A Qt color dialog will displayed. Options Colors Scale Set the color of the scale on a graph. These are the numbers to the top and right of the graph that label the interval of the graph. A Qt color dialog will displayed. Options Angle Degrees Angles are calculated in degrees. Options Angle Radians Angles are calculated in radians. Animation This menu is visible for all graphs with the exception of the stat plot graph. For more detailed information about animating graphs, see . Animation Play Plays and animation. This will loop until Pause or Stop is selected. Animation Pause Pauses an animation, leaving the current n-value alone Animation Stop Stop the animation and resets the n-value back to the minimum (NMin) Animation Display N Value Whether or not to display the current n-value of the animation on the graph display. Animation Set Parameters... Opens a dialog that will allow the user to set various animation parameters. See . Zoom Zoom Zoom Standard Zooms to the optimal dimensions for the current type of graph. Zoom Zoom In Zooms in by the factor set in the Set Factor... dialog. Zoom Zoom Out Zooms out by the factor set in the Set Factor... dialog. Zoom Zoom Box Activates zoom box. The user will then click and drag to create an area to zoom in on. Zoom Zoom Stat Zooms to the optimal view for the currently selected plot. Zoom Set Factor... Opens a dialog to set how much the graph is zoomed. Math Functions Math Functions Distance See Math Functions Minimum See Math Functions Maximum See Math Functions Definite Integral See Math Functions Arc Length See Math Functions Mean Value See 3D Graph This menu is, of course, visible for all 3D graphs. 3D Graph Auto Rotate Rotate X Make the graph view rotate continuously about the x-axis. This can be combined with with other rotating options. This can be cancelled by either reselecting this menu item or by manually rotating the graph by dragging within the graph display. 3D Graph Auto Rotate Rotate Y Make the graph view rotate continuously about the y-axis. This can be combined with with other rotating options. This can be cancelled by either reselecting this menu item or by manually rotating the graph by dragging within the graph display. 3D Graph Auto Rotate Rotate Z Make the graph view rotate continuously about the z-axis. This can be combined with with other rotating options. This can be cancelled by either reselecting this menu item or by manually rotating the graph by dragging within the graph display. 3D Graph Auto Rotate Rotate All Make the graph view rotate continuously about the x-, y-, and z-axis. This can be cancelled by either unselecting each of the X, Y, and Z Rotate menu items or by manually rotating the graph by dragging within the graph display. Window Window Tile Tile all graph windows Window Cascade Cascade all graph windows Window Close Close the current graph window Window Definite Integral Close all graph windows Help Help Usage Displays a dialog giving the user information about all available operators, functions, and constants recognized for input as expressions. Help About... Displays a dialog with the authors', contributors', and license information. Frequently Asked Questions There have to be questions, to have a FAQs section ;) Is this program really that easy to use? E-mail me with any questions you may have, and I'll be glad answer them. &fungcalc-credits;