Splitted READMEs

README-en.md

@@ -0,0 +1,340 @@
+
+# Using functions in C++ - Pretty Plots
+
+
+![main2.png](images/main2.png)
+![rsz_mariposa1.png](images/rsz_mariposa1.png)
+![rsz_mariposa.png](images/rsz_mariposa.png)
+
+[version 2016.01.29]
+
+A good way to organize and structure computer programs is dividing them into smaller parts using functions. Each function carries out a specific task of the problem  that we are solving.
+
+You've seen that all programs written in C++ must contain the `main` function where the program begins. You've probably already used functions such as `pow`, `sin`, `cos`, or `sqrt` from the `cmath` library. Since in almost all of the upcoming lab activities you will continue using pre-defined functions, you need to understand how to work with them. In future exercises you will learn how to design and validate functions. In this laboratory experience you will invoke and define functions that compute the coordinates of the points of the graphs of some curves. You will also practice the implementation of arithmetic expressions in C++.
+
+
+## Objectives:
+
+1. Identify the parts of a function: return type, name, list of parameters, and body.
+2. Invoke pre-defined functions by passing arguments by value ("pass by value"), and by reference ("pass by reference").
+3. Implement a simple overloaded function.
+4. Implement a simple function that utilizes parameters by reference.
+5. Implement arithmetic expressions in C++.
+
+## Pre-Lab:
+
+Before you get to the laboratory you should have:
+
+1. Reviewed the following concepts:
+
+    a. the basic elements of a function definition in C++.
+
+    b. how to invoke functions in C++.
+
+    c. the difference between parameters that are passed by value and by reference.
+
+    d. how to return the result of a function.
+
+    e. implement arithmetic expressions in C++.
+
+    f. use functions and arithmetic constants from the `cmath` library.
+
+    g. a circle's graph and equation.
+
+2. Studied the concepts and instructions for the laboratory session.
+
+3. Taken the Pre-Lab quiz that can be found in Moodle.
+
+---
+
+---
+
+## Functions
+
+In mathematics, a function $f$ is a rule that is used to assign to each element $x$ from a set called *domain*, one (and only one) element $y$ from a set called *range*. This rule is commonly represented with an equation, $y=f(x)$. The variable $x$ is the parameter of the function and the variable $y$ will contain the result of the function. A function can have more than one parameter, but only one result. For example, a  function can have the form $y=f(x_1,x_2)$ where there are two parameters, and for each pair $(a,b)$ that is used as an argument in the function, the function has only one value of $y=f(a,b)$. The domain of the function tells us the type of value that the parameter should have and the range tells us the value that the returned result will have.
+
+Functions in programming languages are similar. A function has a series of instructions that take the assigned values as parameters and performs a certain task. In C++ and other programming languages, functions return only one result, as it happens in mathematics. The only difference is that a *programming* function could possibly not return any value (in this case the function is declared as `void`). If the function will return a value, we use the instruction `return`. As in math, you need to specify the types of values that the function's parameters and result will have; this is done when declaring the function.
+
+### Function header:
+
+The first sentence of a function is called the *header* and its structure is as follows:
+
+`type name(type parameter_1, ..., type parameter_n)`
+
+For example,
+
+`int example(int var1, float var2, char &var3)`
+
+would be the header of the function called `example`, which returns an integer value. The function receives as arguments an integer value (and will store a copy in `var1`), a value of type `float` (and will store a copy in `var2`) and the reference to a variable of type `char` that will be stored in the reference variable `var3`. Note that `var3` has a & symbol before the name of the variable. This indicates that `var3` will contain the reference to a character.
+
+
+### Invoking
+
+
+If we want to store the value of the `example` function's result in a variable `result` (that would be of type integer), we invoke the function by passing arguments as follows:
+
+`result=example(2, 3.5, unCar);`
+
+Note that as the function is invoked, you don't include the type of the variables in the arguments. As in the definition for the function `example`, the third parameter `&var3` is a reference variable; what is being sent to the third argument when invoking the function is a *reference* to the variable `unCar`. Any changes that are made on the variable `var3` will change the contents of the variable `unCar`.
+
+You can also use the function's result without having to store it in a variable. For example you could print it:
+
+`cout << "The result of the function example is:" << example(2, 3.5, unCar);`
+
+or use it in an arithmetic expression:
+
+`y=3 + example(2, 3.5, unCar);`
+
+
+
+### Overloaded functions
+
+Overloaded functions are functions that have the same name, but a different *signature*.
+
+The signature of a function is composed of the name of the function, and the types of parameters it receives, but does not include the return type.
+
+The following function prototypes have the same signature:
+
+```
+int example(int, int) ;
+void example(int, int) ;
+string example(int, int) ;
+```
+
+
+Note that each has the same name, `example`, and receives the same amount of parameters of the same type `(int, int)`.
+
+The following function prototypes have different signatures:
+
+```
+int example(int) ;
+int elpmaxe(int) ;
+```
+
+Note that even though the functions have the same amount of parameters with the same type `int`, the name of the functions is different.
+
+The following function prototypes are overloaded versions of the function `example`:
+
+```
+int example(int) ;
+void example(char) ;
+int example(int, int) ;
+int example(char, int) ;
+int example(int, char) ;
+```
+
+All of the above functions have the same name, `example`, but different parameters. The first and second functions have the same amount of parameters, but their arguments are of different types. The fourth and fifth functions have arguments of type `char` and `int`, but in each case are in different order.
+
+In that last example, the function `example` is overloaded since there are 5 functions with different signatures but with the same name.
+
+
+
+### Values by default
+
+Values by default can be assigned to the parameters of the functions starting from the first parameter to the right. It is not necessary to initialize all of the parameters, but the ones that are initialized should be consecutive: parameters in between two parameters cannot be left uninitialized. This allows calling the function without having to send values in the positions that correspond to the initialized parameters.
+
+**Examples of function headers and valid invocations:**
+
+1. **Headers:** `int example(int var1, float var2, int var3 = 10)`
+
+    **Invocations:**
+
+    a. `example(5, 3.3, 12)` This function call assigns the value 5 to `var1`, the value 3.3 to `var2`, and the value of 12 to `var3`.
+
+    b. `example(5, 3.3)` This function call sends the values for the first two parameters and the value for the last parameter will be the value assigned by default in the header. That is, the values in the variables in the function will be as follows: `var1` will be 5, `var2` will be 3.3, and `var3` will be 10.
+
+2. **Header:** `int example(int var1, float var2=5.0, int var3 = 10)`
+
+    **Invocations:**
+
+    a. `example(5, 3.3, 12)` This function call assigns the value 5 to `var1`, the value 3.3 to `var2`, and the value 12 to `var3`.
+
+    b. `example(5, 3.3)` In this function call only the first two parameters are given values, and the value for the last parameter is the value by default. That is, the value for `var1` within the function will be 5, that of `var2` will be 3.3, and `var3` will be 10.
+
+    c. `example(5)` In this function call only the first parameter is given a value, and the last two parameters will be assigned  values by default. That is, `var1` will be 5, `var2` will be 5.0, and `var3` will be 10.
+
+
+**Example of a valid function header with invalid invocations:**
+
+1. **Header:** `int example(int var1, float var2=5.0, int var3 = 10)`
+
+    **Invocation:**
+
+    a. `example(5, , 10)` This function call is **invalid** because it leaves an empty space in the middle argument.
+
+    b. `example()` This function call is **invalid** because `var1` was not assigned a default value. A valid invocation to the function `example` needs at least one argument (the first).
+
+
+**Examples of invalid function headers:**
+
+1. `int example(int var1=1, float var2, int var3)` This header is invalid because  the  default values can only be assigned starting from the rightmost parameter.
+
+2. `int example(int var1=1, float var2, int var3=10)` This header is invalid because you can't place parameters without values between other parameters with default values. In this case, `var2` doesn't have a default value but `var1` and `var3` do.
+
+
+---
+
+---
+
+## Parametric equations
+
+*Parametric equations* allow us to represent a quantity as a function of one or more independent variables called *parameters*. In many occasions it is useful to represent curves using a set of parametric equations that express the coordinates of the points of the curve as functions of the parameters. For example, in your trigonometry course you should have studied that the equation of the circle of radius $r$ and centered at the origin has the following form:
+
+
+$$x^2+y^2=r^2.$$
+
+The points $(x,y)$ that satisfy this equation are the points that form the circle of radius $r$ and center at the origin. For example, the circle with $r=2$ and center at the origin has equation
+
+
+$$x^2+y^2=4,$$
+
+and its points are the ordered pairs $(x,y)$ that satisfy this equation. A parametric representation of the coordinates of the points in the circle of radius $r$ and center at the origin is:
+
+
+$$x=r \cos(t)$$
+
+$$y=r \sin(t),$$
+
+where $t$ is a parameter that corresponds to the measure (in radians) of the positive angle  with initial side that coincides with the positive part of the $x$-axis and terminal side that contains the point $(x,y)$, as it is illustrated in Figure 1.
+
+
+---
+
+![circulo.jpg](images/circuloAngulo01.png)
+
+**Figure 1.** Circle with center in the origin and radius $r$.
+
+
+---
+
+To plot a curve that is described  by parametric equations, we compute the $x$ and $y$ values for a set of values of the parameter. For example, for $r=2$, some of the values are
+
+
+---
+
+![circulo.jpg](images/circuloPuntos01.png)
+
+**Figure 2.** Some coordinates for the points $(x,y)$ for the circle with radius $r=2$ and center in the origin.
+
+---
+
+---
+
+## Laboratory session:
+
+In the introduction to the topic of functions you saw that in mathematics and in some programming languages, a function cannot return more than one result. In this laboratory experience's exercises you will practice how to use reference variables to obtain various results from a function.
+
+### Exercise 1
+
+In this exercise you will study the difference between pass by value and pass by reference.
+
+**Instructions**
+
+1. Load the project `prettyPlot` in Qt by double clicking on the file `prettyPlot.pro` in the folder `Documents/eip/Functions-PrettyPlots` of your computer. You may also go to `http://bitbucket.org/eip-uprrp/functions-prettyplots` to download the folder `Functions-PrettyPlots` to your computer.
+
+2. Configure the project and execute the program by clicking on the green arrow in the menu on the left side of the Qt Creator screen. The program should show a window similar to the one in Figure 3.
+
+    ---
+
+    ![Figura3.png](images/Figura3.png)
+
+    **Figure 3.**  Graph of a circle with radius 5 and center in the origin displayed by the program *PrettyPlot*.
+
+    ---
+
+3. Open the file `main.cpp` (in Sources). Study the `illustration` function and how to call it from the `main` function. Note that the variables `argValue` and `argRef`are initialized to 0 and that the function call for `illustration` makes a pass by value of `argValue` and a pass by reference of `argRef`. Also note that the corresponding parameters in `illustration` are assigned a value of 1.
+
+        void illustration(int paramValue, int &paramRef) {
+            paramValue = 1;
+            paramRef = 1;
+            cout << endl << "The content of paramValue is: " << paramValue << endl
+                 << "The content of paramRef is: " << paramRef << endl;
+        }
+
+4. Execute the program and observe what is displayed in the window `Application Output`. Notice the difference between the content of the variables `argValue` and `argRef` despite the fact that both had the same initial value, and that `paramValue` and `paramRef` were assigned the same value. Explain why the content of `argValor` does not change, while the content of `argRef` changes from 0 to 1.
+
+### Exercise 2
+
+In this exercise you will practice the creation of an overloaded function.
+
+**Instructions**
+
+1. Study the code in the `main()` function in the file `main.cpp`.
+
+        XYPlotWindow wCircleR5;
+        XYPlotWindow wCircle;
+        XYPlotWindow wButterfly;
+
+        double r;
+        double y = 0.00;
+        double x = 0.00;
+        double increment = 0.01;
+        int argValue=0, argRef=0;
+
+        // invoke the function illustration to view the contents of variables
+        // by value and by reference
+
+            illustration(argValue,argRef);
+            cout << endl << "The content of argValue is: " << argValue << endl
+                 << "The content of argRef is: " << argRef << endl;
+
+        // repeat for several values of the angle t
+        for (double t = 0; t < 16*M_PI; t = t + increment) {
+
+            // invoke circle with the angle t and reference variables x, y as arguments
+            circle(t,x,y);
+
+            // add the point (x,y) to the graph of the circle
+            wCircleR5.AddPointToGraph(x,y);
+
+    The line `XYPlotWindow wCircleR5;` creates a `wCircleR5` object that will be the window where the graph will be drawn, in this case the graph of a circle of radius 5. In a similar way, the objects `wCircle` and `wButterfly` are created. Observe the `for` cycle. In this cycle a series of values for the angle $t$ is generated and the function `circle` is invoked, passing the value for $t$ and the references to $x$ and $y$. The `circle` function does not return a value, but using parameters by reference, it calculates the values for the coordinates $xCoord$ and $yCoord$ for the circle with center in the origin and radius 5, and allows the `main` function  to have these values in the `x` , `y` variables.
+
+    After the function call, each ordered pair $(x,y)$ is added to the circle’s graph by the member function `AddPointToGraph(x,y)`. After the cycle, the member function `Plot()` is invoked, which draws the points, and the member function `show()`, which displays the graph. The *members functions* are functions that allow use to work with and object’s data. Notice that each one of the member functions is written after `wCircleR5`, followed by a period. In an upcoming laboratory experience you will learn more about objects, and practice how to create them and invoke their method functions.
+
+    The `circle` function implemented in the program is very restrictive since it always calculates the values for the coordinates $x$ and $y$ of the same circle: the circle with center in the origin and radius 5.
+
+2. Now you will create an overloaded function `circle` that receives as arguments the value of the angle $t$, the reference to the variables $x$ and $y$, and the value for the radius of the circle. Invoke the overloaded function `circle` that you just implemented from `main()` to calculate the values of the coordinates $x$ and $y$ for the circle with radius 15 and draw its graph. Graph the circle within the `wCircle` object. To do this, you must invoke the method functions `AddPointToGraph(x,y)`, `Plot` and `show` from `main()`. Remember that these should be preceded by `wCircle`, for example, `wCircle.show()`.
+
+### Exercise 3
+
+In this exercise you will implement another function to calculate the coordinates of the points in the graph of a curve.
+
+**Instructions**
+
+1. Now you will create a function to calculate the coordinates of the points of a graph that resembles a butterfly. The parametric equations for the coordinates of the points in the graph are given by:
+
+    $$x=5\cos(t) \left[ \sin^2(1.2t) + \cos^3(6t) \right]$$
+
+    $$y= 10\sin(t) \left[ \sin^2(1.2t) +  \cos^3(6t) \right].$$
+
+    Observe that both expressions are almost the same, except that one starts with $5\cos(t)$ and the other with $10\sin(t)$. Instead of doing the calculation for $ \sin^2(1.2t) + \cos^3(6t)$ twice, you can assign its value to another variable $q$ and calculate it as such:
+
+    $$q =  \sin^2(1.2t) + \cos^3(6t)$$
+
+    $$x = 5 \cos(t)(q)$$
+
+    $$y = 10  \sin(t)(q).$$
+
+2. Implement the function `butterfly` using the expressions above, invoke the function in `main()` and observe the resulting graph. It is supposed to look like a butterfly. This graph should have been obtained with a `XYPlotWindow` object called `wButterfly`, invoking method functions similar to how you did in Exercise 2 for the circle.
+
+In [2] and [3] you can find other parametric equations from other interesting curves.
+
+---
+---
+
+##Deliverables
+
+Use "Deliverables" in Moodle to hand in the file `main()` that contains the functions you implemented, the function calls and changes you made in exercises 2 and 3. Remember to use good programming techniques, include the name of the programmers involved and document your program.
+
+
+---
+
+---
+
+##References
+
+[1] http://mathbits.com/MathBits/CompSci/functions/UserDef.htm
+
+[2] http://paulbourke.net/geometry/butterfly/
+
+[3] http://en.wikipedia.org/wiki/Parametric_equation

README-es.md

@@ -0,0 +1,366 @@
+
+# Utilizando funciones en C++ - Gráficas Bonitas
+
+
+![main2.png](images/main2.png)
+![rsz_mariposa1.png](images/rsz_mariposa1.png)
+![rsz_mariposa.png](images/rsz_mariposa.png)
+
+[version 2016.02.02]
+
+Una buena manera de organizar y estructurar los programas de computadoras es dividiéndolos en partes más pequeñas utilizando funciones. Cada función realiza una tarea específica del problema que estamos resolviendo.
+
+Haz visto que todos los programas en C++ deben contener la función `main` que es donde comienza el programa. Probablemente ya haz utilizado funciones como `pow`, `sin`, `cos`  o `sqrt` de la biblioteca de matemática `cmath`. Dado que en casi todas las experiencias de laboratorio futuras estarás utilizando funciones que ya han sido creadas, necesitas aprender cómo trabajar con ellas. Más adelante aprenderás cómo diseñarlas y validarlas. En esta experiencia de laboratorio invocarás y definirás funciones que calculan las coordenadas de los puntos de las gráficas de algunas curvas. También practicarás la implementación de expresiones aritméticas en C++.
+
+
+## Objetivos:
+
+1. Identificar las partes de una función: tipo, nombre, lista de parámetros y cuerpo de la función.
+2. Invocar funciones ya creadas enviando argumentos por valor ("pass by value") y por referencia ("pass by reference").
+3. Implementar una función sobrecargada simple.
+4. Implementar funciones simples que utilicen parámetros por referencia.
+5. Implementar expresiones aritméticas en C++
+
+
+
+## Pre-Lab:
+
+Antes de llegar al laboratorio  debes:
+
+1. Haber repasado los siguientes conceptos:
+
+    a. los elementos básicos de la definición de una función en C++.
+
+    b. la manera de invocar funciones en C++.
+
+    c. la diferencia entre  parámetros pasados por valor y por referencia.
+
+    d. cómo devolver el resultado de una función.
+
+    e. implementar expresiones aritméticas en C++.
+
+    f. utilizar funciones y constantes aritméticas de la biblioteca `cmath`.
+
+    g. la ecuación y gráfica de un círculo.
+
+2. Haber estudiado los conceptos e instrucciones para la sesión de laboratorio.
+
+
+---
+
+---
+
+
+## Funciones
+
+En matemática, una función $f$ es una regla que se usa para asignar a cada elemento $x$ de un conjunto que se llama *dominio*, uno (y solo un) elemento $y$ de un conjunto que se llama *campo de valores*. Por lo general, esa regla se representa como una ecuación, $y=f(x)$. La variable $x$ es el parámetro de la función y la variable $y$ contendrá el resultado de la función. Una función puede tener más de un parámetro pero solo un resultado. Por ejemplo, una función puede tener la forma $y=f(x_1,x_2)$ en donde hay dos parámetros y para cada par $(a,b)$ que se use como argumento de la función, la función tiene un solo valor de $y=f(a,b)$. El dominio de la función te dice el tipo de valor que debe tener el parámetro y el campo de valores el tipo de valor que tendrá el resultado que devuelve la función.
+
+Las funciones en lenguajes de programación de computadoras son similares. Una función
+tiene una serie de instrucciones que toman los valores asignados a los parámetros y realiza alguna tarea. En C++ y en algunos otros lenguajes de programación,  las funciones pueden devolver a lo sumo un resultado, tal y como sucede en matemáticas. La única diferencia es que una función en programación puede que no devuelva valor (en este caso la función se declara `void`). Si la función va a devolver algún valor, se hace con la instrucción `return`. Al igual que en matemática tienes que especificar el dominio y el campo de valores, en programación tienes que especificar los tipos de valores que tienen los parámetros y el resultado que devuelve la función; esto lo haces al declarar la función.
+
+### Encabezado de una función:
+
+La primera oración de una función se llama el *encabezado* y su estructura es como sigue:
+
+`tipo nombre(tipo parámetro_1, ..., tipo parámetro_n)`
+
+Por ejemplo,
+
+`int ejemplo(int var1, float var2, char &var3)`
+
+sería el encabezado de la función llamada `ejemplo`, que devuelve un valor entero. La función recibe como argumentos un valor entero (y guardará una copia en `var1`), un valor de tipo `float` (y guardará una copia en `var2`) y la referencia a una variable de tipo  `char` que se guardará en la variable de referencia `var3`. Nota que `var3` tiene el signo `&` antes del nombre de la variable. Esto indica que `var3` contendrá la referencia a un caracter.
+
+### Invocación
+
+Si queremos guardar el valor del resultado de la función `ejemplo` en la variable `resultado` (que deberá ser de tipo entero), invocamos la función pasando argumentos de manera similar a:
+
+`resultado=ejemplo(2, 3.5, unCar);`
+
+Nota que al invocar funciones no incluyes el tipo de las variables en los argumentos. Como en la definición de la función `ejemplo` el tercer parámetro `&var3` es una variable de referencia, lo que se está enviando en el tercer argumento de la invocación es una *referencia* a la variable `unCar`. Los cambios que se hagan en la variable `var3` están cambiando el contenido de la variable `unCar`.
+
+También puedes usar el resultado de la función sin tener que guardarlo en una variable. Por ejemplo puedes imprimirlo:
+
+`cout << "El resultado de la función ejemplo es:" << ejemplo(2, 3.5, unCar);`
+
+o utilizarlo en una expresión aritmética:
+
+`y=3 + ejemplo(2, 3.5, unCar);`
+
+
+
+
+### Funciones sobrecargadas (‘overloaded’)
+
+Las funciones sobrecargadas son funciones que poseen el mismo nombre, pero tienen *firmas* diferentes.
+
+La firma de una función se compone del nombre de la función, y los tipos de parámetros que recibe, pero no incluye el tipo que devuelve.
+
+Los siguientes prototipos de funciones tienen la misma firma:
+
+```
+int ejemplo(int, int) ;
+void ejemplo(int, int) ;
+string ejemplo(int, int) ;
+```
+
+Nota que todas tienen el mismo nombre, `ejemplo`, y reciben la misma cantidad de parámetros del mismo tipo `(int, int)`.
+
+Los siguientes prototipos de  funciones tienen firmas diferentes:
+
+```
+int ejemplo(int) ;
+int olpmeje(int) ;
+```
+Nota que a pesar de que las funciones tienen la misma cantidad de parámetros con mismo tipo `int`, el nombre de las funciones es distinto.
+
+Los siguientes prototipos de funciones son versiones sobrecargadas de la función `ejemplo`:
+
+```
+int ejemplo(int) ;
+void ejemplo(char) ;
+int ejemplo(int, int) ;
+int ejemplo(char, int) ;
+int ejemplo(int, char) ;
+```
+
+
+Todas las funciones de arriba tienen el mismo nombre, `ejemplo`, pero distintos parámetros.  La primera y segunda función tienen la misma cantidad de parámetros, pero los argumentos son de distintos tipos.  La cuarta y quinta función tienen argumentos de tipo `char` e `int`, pero en cada caso están en distinto orden.
+
+En este último ejemplo la función ejemplo es sobrecargada ya que hay 5 funciones con firma distinta pero con el mismo nombre.
+
+
+
+### Valores por defecto
+
+Se pueden asignar valores por defecto ("default") a los parámetros de las funciones comenzando desde el parámetro más a la derecha. No hay que inicializar todos los parámetros pero los que se inicializan deben ser consecutivos: no se puede dejar parámetros sin inicializar entre dos parámetros que estén inicializados. Esto permite la invocación de la función sin tener que enviar los valores en las posiciones que corresponden a parámetros inicializados.
+
+**Ejemplos de encabezados de funciones e invocaciones válidas:**
+
+1. **Encabezado:** `int ejemplo(int var1, float var2, int var3 = 10)`
+
+     **Invocaciones:**
+
+    a. `ejemplo(5, 3.3, 12)` Esta invocación asigna el valor 5 a `var1`, el valor 3.3 a `var2`, y el valor 12 a `var3`.
+
+    b. `ejemplo(5, 3.3)`  Esta invocación envía valores para los primeros dos parámetros y el valor del último parámetro será el valor por defecto asignado en el encabezado. Esto es, los valores de las variables en la función serán: `var1` tendrá 5, `var2` tendrá 3.3, y `var3` tendrá 10.
+
+
+2. **Encabezado:** `int ejemplo(int var1, float var2=5.0, int var3 = 10)`
+
+    **Invocaciones:**
+
+    a. `ejemplo(5, 3.3, 12)` Esta invocación asigna el valor 5 a `var1`, el valor 3.3 a `var2`, y el valor 12 a  `var3`.
+
+    b. `ejemplo(5, 3.3)` En esta invocación solo se envían valores para los primeros dos parámetros, y el valor del último parámetro es el valor por defecto.  Esto es, el valor de `var1` dentro de la función será 5, el de `var2` será 3.3 y el de `var3` será 10.
+
+    c. `ejemplo(5)` En esta invocación solo se envía valor para el primer parámetro, y los últimos dos parámetros tienen valores por defecto.  Esto es,  el valor de `var1` dentro de la función será 5, el de `var2` será 5.0 y el de `var3` será 10.
+
+**Ejemplo de un encabezado de funciones válido con invocaciones inválidas:**
+
+1. **Encabezado:** `int ejemplo(int var1, float var2=5.0, int var3 = 10)`
+
+    **Invocación:**
+
+    a. `ejemplo(5, ,10)` Esta invocación  es **inválida** porque   deja espacio vacío en el argumento del medio.
+
+    b. `ejemplo()` Esta invocación es **inválida** ya que `var1` no estaba inicializada y no recibe ningún valor en la invocación.
+
+**Ejemplos de encabezados de funciones inválidos:**
+
+1. `int ejemplo(int var1=1, float var2, int var3)` Este encabezado es inválido porque los valores por defecto solo se pueden asignar comenzando por el parámetro más a la derecha.
+
+2. `int ejemplo(int var1=1, float var2, int var3=10)` Este encabezado es inválido porque no se pueden poner parámetros sin valores en medio de parámetros con valores por defecto. En este caso  `var2` no tiene valor pero `var1` y `var3` si.
+
+
+
+---
+
+---
+
+## Ecuaciones paramétricas
+
+Las *ecuaciones paramétricas* nos permiten representar una cantidad como función de una o más variables independientes llamadas *parámetros*. En muchas ocasiones resulta útil representar curvas utilizando un conjunto de ecuaciones paramétricas que expresen las coordenadas de los puntos de la curva como funciones de los parámetros. Por ejemplo, en tu curso de trigonometría debes haber estudiado que la ecuación de un círculo con radio $r$ y centro en el origen tiene una forma así:
+
+$$x^2+y^2=r^2.$$
+
+
+Los puntos $(x,y)$ que satisfacen esta ecuación son los puntos que forman el círculo de radio $r$ y centro en el origen.  Por ejemplo, el círculo con $r=2$ y centro en el origen tiene ecuación
+
+$$x^2+y^2=4,$$
+
+y sus puntos son los pares ordenados $(x,y)$ que satisfacen esa ecuación. Una forma paramétrica de expresar las coordenadas de los puntos del círculo con radio $r$ y centro en el origen es:
+
+$$x=r \cos(t)$$
+
+$$y=r \sin(t),$$
+
+donde $t$ es un parámetro que corresponde a la medida (en radianes) del ángulo positivo con lado inicial que coincide con la parte positiva del eje de $x$, y lado terminal que contiene el punto $(x,y)$, como se muestra en la Figura 1.
+
+
+---
+
+![circulo.jpg](images/circuloAngulo01.png)
+
+**Figura 1.** Círculo con centro en el origen y radio $r$.
+
+
+---
+
+Para graficar una curva que está definida usando ecuaciones paramétricas, computamos los valores de $x$ y $y$ para un conjunto de valores del parámetro. Por ejemplo, la Figura 2 resalta los valores de $t$, $(x,y)$ para el círculo con $r = 2$.
+
+---
+
+
+
+![circulo.jpg](images/circuloPuntos01.png)
+
+**Figura 2.** Algunas coordenadas de los puntos $(x,y)$ del círculo con radio $r=2$ y centro en el origen.
+
+---
+
+---
+
+
+
+!INCLUDE "../../eip-diagnostic/DVD/es/diag-dvd-01.html"
+
+!INCLUDE "../../eip-diagnostic/DVD/es/diag-dvd-03.html"
+
+!INCLUDE "../../eip-diagnostic/DVD/es/diag-dvd-11.html"
+
+!INCLUDE "../../eip-diagnostic/DVD/es/diag-dvd-12.html"
+
+---
+
+---
+
+
+## Sesión de laboratorio:
+
+En la introducción al tema de funciones viste que, tanto en matemáticas como en algunos lenguajes de programación, una función no puede devolver más de un resultado. En los ejercicios de esta experiencia de laboratorio practicarás cómo usar variables de referencia para poder obtener varios resultados de una función.
+
+### Ejercicio 1
+
+En este ejercicio estudiarás la diferencia entre pase por valor y pase por referencia.
+
+**Instrucciones**
+
+1. Descarga la carpeta `Functions-PrettyPlots` de `Bitbucket` usando un terminal, moviéndote al directorio `Documents/eip`,  y escribiendo el comando `git clone http://bitbucket.org/eip-uprrp/functions-prettyplots`.
+
+2. Carga a Qt Creator el proyecto `prettyPlot`  haciendo doble "click" en el archivo `prettyPlot.pro` que se encuentra en la carpeta `Documents/eip/Functions-PrettyPlots` de tu computadora.
+
+3. Configura el proyecto y ejecuta el programa marcando la flecha verde en el menú de la izquierda de la interface de Qt Creator. El programa debe mostrar una ventana parecida a la Figura 3.
+
+
+    ---
+
+    ![Figura3.png](images/Figura3.png)
+
+    **Figura 3.** Gráfica de un círculo de radio 5 y centro en el origen desplegada por el programa *PrettyPlot*.
+
+    ---
+
+3. Abre el archivo `main.cpp` (en Sources).  Estudia la función `illustration` y su invocación desde la función `main`. Nota que las variables `argValue` y `argRef` están inicializadas a 0 y que la invocación a `illustration` hace un pase por valor de `argValue` y un pase por referencia de `argRef`. Nota también que a los parámetros correspondientes en `illustration` se les asigna el valor 1.
+
+        void illustration(int paramValue, int &paramRef) {
+            paramValue = 1;
+            paramRef = 1;
+            cout << endl << "The content of paramValue is: " << paramValue << endl
+                 << "The content of paramRef is: " << paramRef << endl;
+        }
+
+4. Ejecuta el programa y observa lo que se despliega en la ventana `Application Output`. Nota la diferencia entre el contenido las variables `argValue` y `argRef` a pesar de que ambas tenían el mismo valor inicial y de que a `paramValue` y `paramRef` se les asignó el mismo valor. Explica por qué el contenido de `argValor` no cambia, mientras que el contenido de `argRef` cambia de 0 a 1.
+
+### Ejercicio 2
+
+En este ejercicio practicarás la creación de una función sobrecargada.
+
+**Instrucciones**
+
+1. Estudia el código de la función `main()` del archivo `main.cpp`. La línea `XYPlotWindow wCircleR5;` crea el objeto `wCircleR5` que será la ventana en donde se dibujará una gráfica, en este caso la gráfica de un círculo de radio 5. De manera similar se crean los objetos `wCircle` y `wButterfly`. Observa el ciclo `for`. En este ciclo se genera una serie de valores para el ángulo $t$ y se invoca la función `circle`, pasándole el valor de $t$ y las referencias a $x$ y $y$. La función `circle` no devuelve valor pero, usando parámetros por referencia, calcula valores para las coordenadas $xCoord$ y $yCoord$ del círculo con centro en el origen y radio 5 y permite que la función `main` tenga esos valores en las variables `x` , `y`.
+
+        XYPlotWindow wCircleR5;
+        XYPlotWindow wCircle;
+        XYPlotWindow wButterfly;
+
+        double r;
+        double y = 0.00;
+        double x = 0.00;
+        double increment = 0.01;
+        int argValue=0, argRef=0;
+
+        // invoke the function illustration to view the contents of variables
+        // by value and by reference
+
+            illustration(argValue,argRef);
+            cout << endl << "The content of argValue is: " << argValue << endl
+                 << "The content of argRef is: " << argRef << endl;
+
+        // repeat for several values of the angle t
+        for (double t = 0; t < 16*M_PI; t = t + increment) {
+
+            // invoke circle with the angle t and reference variables x, y as arguments
+            circle(t,x,y);
+
+            // add the point (x,y) to the graph of the circle
+            wCircleR5.AddPointToGraph(x,y);
+
+    Luego de la invocación, cada par ordenado $(x,y)$  es añadido a la gráfica del círculo por el método `AddPointToGraph(x,y)`. Luego del ciclo se invoca el método `Plot()`, que "dibuja" los puntos, y el método `show()`, que muestra la gráfica. Los *métodos* son funciones que nos permiten trabajar con los datos de los objetos. Nota que cada uno de los métodos se escribe luego de `wCircleR5`, seguido de un punto. En una experiencia de laboratorio posterior aprenderás más sobre objetos y practicarás cómo crearlos e invocar sus métodos.
+
+    La función `circle` implementada en el programa es muy restrictiva ya que siempre calcula los valores para las coordenadas $x$ y $y$ del mismo círculo: el círculo con centro en el origen y radio 5.
+
+2. Ahora crearás una función sobrecargada `circle` que reciba como argumentos el valor del ángulo $t$, la referencia a las variables $x$ y $y$, y el valor para el radio del círculo. Invoca desde `main()` la función sobrecargada  `circle` que acabas de implementar para calcular los valores de las coordenadas $x$ y $y$ del círculo con radio 15 y dibujar su gráfica. Grafica el círculo dentro del objeto `wCircle`. Para esto, debes invocar desde `main()` los métodos `AddPointToGraph(x,y)`, `Plot` y `show`. Recuerda que éstos deben ser precedidos por `wCircle`, por ejemplo, `wCircle.show()`.
+
+### Ejercicio 3
+
+En este ejercicio implantarás otra función para calcular las coordenadas de los puntos de la gráfica de una curva.
+
+**Instrucciones**
+
+1. Ahora crearás una función para calcular las coordenadas de los puntos de la gráfica que parece una mariposa. Las ecuaciones paramétricas para las coordenadas de los puntos de la gráfica están dadas por:
+
+    $$x=5\cos(t) \left[ \sin^2(1.2t) + \cos^3(6t) \right]$$
+
+    $$y= 10\sin(t) \left[ \sin^2(1.2t) +  \cos^3(6t) \right].$$
+
+    Observa que ambas expresiones son casi iguales, excepto que una comienza con $5\cos(t)$ y la otra con $10\sin(t)$. En lugar de realizar el cómputo de $ \sin^2(1.2t) + \cos^3(6t)$ dos veces, puedes asignar su valor a otra variable $q$ y realizar el cómputo así:
+
+    $$q =  \sin^2(1.2t) + \cos^3(6t)$$
+
+    $$x = 5 \cos(t)(q)$$
+
+    $$y = 10  \sin(t)(q).$$
+
+2. Implementa la función `butterfly` utilizando las expresiones de arriba, invoca la función desde `main()` y observa la gráfica que resulta. Se supone que parezca una mariposa. Esta gráfica debe haber sido obtenida dentro de un objeto `XYPlotWindow` llamado `wButterfly`, invocando métodos de manera similar a como hiciste en el Ejercicio 2 para el círculo.
+
+En [2] y [3] puedes encontrar otras ecuaciones paramétricas de otras curvas interesantes.
+
+
+---
+
+---
+
+## Entregas
+
+Utiliza "Entrega" en Moodle para entregar el archivo `main.cpp` que contiene las funciones que implementaste, las invocaciones y  cambios que hiciste en los ejercicios 2 y 3. Recuerda utilizar buenas prácticas de programación, incluir el nombre de los programadores y documentar tu programa.
+
+
+
+---
+
+---
+
+##Referencias
+
+[1] http://mathbits.com/MathBits/CompSci/functions/UserDef.htm
+
+[2] http://paulbourke.net/geometry/butterfly/
+
+[3] http://en.wikipedia.org/wiki/Parametric_equation
+
+---
+
+---
+
+---
+

README.md

@@ -1,708 +1,2 @@
-[English](#markdown-header-using-functions-in-c-pretty-plots) | [Español](#markdown-header-utilizando-funciones-en-c-graficas-bonitas)
-
-# Utilizando funciones en C++ - Gráficas Bonitas
-
-
-![main2.png](images/main2.png)
-![rsz_mariposa1.png](images/rsz_mariposa1.png)
-![rsz_mariposa.png](images/rsz_mariposa.png)
-
-[version 2016.02.02]
-
-Una buena manera de organizar y estructurar los programas de computadoras es dividiéndolos en partes más pequeñas utilizando funciones. Cada función realiza una tarea específica del problema que estamos resolviendo.
-
-Haz visto que todos los programas en C++ deben contener la función `main` que es donde comienza el programa. Probablemente ya haz utilizado funciones como `pow`, `sin`, `cos`  o `sqrt` de la biblioteca de matemática `cmath`. Dado que en casi todas las experiencias de laboratorio futuras estarás utilizando funciones que ya han sido creadas, necesitas aprender cómo trabajar con ellas. Más adelante aprenderás cómo diseñarlas y validarlas. En esta experiencia de laboratorio invocarás y definirás funciones que calculan las coordenadas de los puntos de las gráficas de algunas curvas. También practicarás la implementación de expresiones aritméticas en C++.
-
-
-## Objetivos:
-
-1. Identificar las partes de una función: tipo, nombre, lista de parámetros y cuerpo de la función.
-2. Invocar funciones ya creadas enviando argumentos por valor ("pass by value") y por referencia ("pass by reference").
-3. Implementar una función sobrecargada simple.
-4. Implementar funciones simples que utilicen parámetros por referencia.
-5. Implementar expresiones aritméticas en C++
-
-
-
-## Pre-Lab:
-
-Antes de llegar al laboratorio  debes:
-
-1. Haber repasado los siguientes conceptos:
-
-    a. los elementos básicos de la definición de una función en C++.
-
-    b. la manera de invocar funciones en C++.
-
-    c. la diferencia entre  parámetros pasados por valor y por referencia.
-
-    d. cómo devolver el resultado de una función.
-
-    e. implementar expresiones aritméticas en C++.
-
-    f. utilizar funciones y constantes aritméticas de la biblioteca `cmath`.
-
-    g. la ecuación y gráfica de un círculo.
-
-2. Haber estudiado los conceptos e instrucciones para la sesión de laboratorio.
-
-
----
-
----
-
-
-## Funciones
-
-En matemática, una función $f$ es una regla que se usa para asignar a cada elemento $x$ de un conjunto que se llama *dominio*, uno (y solo un) elemento $y$ de un conjunto que se llama *campo de valores*. Por lo general, esa regla se representa como una ecuación, $y=f(x)$. La variable $x$ es el parámetro de la función y la variable $y$ contendrá el resultado de la función. Una función puede tener más de un parámetro pero solo un resultado. Por ejemplo, una función puede tener la forma $y=f(x_1,x_2)$ en donde hay dos parámetros y para cada par $(a,b)$ que se use como argumento de la función, la función tiene un solo valor de $y=f(a,b)$. El dominio de la función te dice el tipo de valor que debe tener el parámetro y el campo de valores el tipo de valor que tendrá el resultado que devuelve la función.
-
-Las funciones en lenguajes de programación de computadoras son similares. Una función
-tiene una serie de instrucciones que toman los valores asignados a los parámetros y realiza alguna tarea. En C++ y en algunos otros lenguajes de programación,  las funciones pueden devolver a lo sumo un resultado, tal y como sucede en matemáticas. La única diferencia es que una función en programación puede que no devuelva valor (en este caso la función se declara `void`). Si la función va a devolver algún valor, se hace con la instrucción `return`. Al igual que en matemática tienes que especificar el dominio y el campo de valores, en programación tienes que especificar los tipos de valores que tienen los parámetros y el resultado que devuelve la función; esto lo haces al declarar la función.
-
-### Encabezado de una función:
-
-La primera oración de una función se llama el *encabezado* y su estructura es como sigue:
-
-`tipo nombre(tipo parámetro_1, ..., tipo parámetro_n)`
-
-Por ejemplo,
-
-`int ejemplo(int var1, float var2, char &var3)`
-
-sería el encabezado de la función llamada `ejemplo`, que devuelve un valor entero. La función recibe como argumentos un valor entero (y guardará una copia en `var1`), un valor de tipo `float` (y guardará una copia en `var2`) y la referencia a una variable de tipo  `char` que se guardará en la variable de referencia `var3`. Nota que `var3` tiene el signo `&` antes del nombre de la variable. Esto indica que `var3` contendrá la referencia a un caracter.
-
-### Invocación
-
-Si queremos guardar el valor del resultado de la función `ejemplo` en la variable `resultado` (que deberá ser de tipo entero), invocamos la función pasando argumentos de manera similar a:
-
-`resultado=ejemplo(2, 3.5, unCar);`
-
-Nota que al invocar funciones no incluyes el tipo de las variables en los argumentos. Como en la definición de la función `ejemplo` el tercer parámetro `&var3` es una variable de referencia, lo que se está enviando en el tercer argumento de la invocación es una *referencia* a la variable `unCar`. Los cambios que se hagan en la variable `var3` están cambiando el contenido de la variable `unCar`.
-
-También puedes usar el resultado de la función sin tener que guardarlo en una variable. Por ejemplo puedes imprimirlo:
-
-`cout << "El resultado de la función ejemplo es:" << ejemplo(2, 3.5, unCar);`
-
-o utilizarlo en una expresión aritmética:
-
-`y=3 + ejemplo(2, 3.5, unCar);`
-
-
-
-
-### Funciones sobrecargadas (‘overloaded’)
-
-Las funciones sobrecargadas son funciones que poseen el mismo nombre, pero tienen *firmas* diferentes.
-
-La firma de una función se compone del nombre de la función, y los tipos de parámetros que recibe, pero no incluye el tipo que devuelve.
-
-Los siguientes prototipos de funciones tienen la misma firma:
-
-```
-int ejemplo(int, int) ;
-void ejemplo(int, int) ;
-string ejemplo(int, int) ;
-```
-
-Nota que todas tienen el mismo nombre, `ejemplo`, y reciben la misma cantidad de parámetros del mismo tipo `(int, int)`.
-
-Los siguientes prototipos de  funciones tienen firmas diferentes:
-
-```
-int ejemplo(int) ;
-int olpmeje(int) ;
-```
-Nota que a pesar de que las funciones tienen la misma cantidad de parámetros con mismo tipo `int`, el nombre de las funciones es distinto.
-
-Los siguientes prototipos de funciones son versiones sobrecargadas de la función `ejemplo`:
-
-```
-int ejemplo(int) ;
-void ejemplo(char) ;
-int ejemplo(int, int) ;
-int ejemplo(char, int) ;
-int ejemplo(int, char) ;
-```
-
-
-Todas las funciones de arriba tienen el mismo nombre, `ejemplo`, pero distintos parámetros.  La primera y segunda función tienen la misma cantidad de parámetros, pero los argumentos son de distintos tipos.  La cuarta y quinta función tienen argumentos de tipo `char` e `int`, pero en cada caso están en distinto orden.
-
-En este último ejemplo la función ejemplo es sobrecargada ya que hay 5 funciones con firma distinta pero con el mismo nombre.
-
-
-
-### Valores por defecto
-
-Se pueden asignar valores por defecto ("default") a los parámetros de las funciones comenzando desde el parámetro más a la derecha. No hay que inicializar todos los parámetros pero los que se inicializan deben ser consecutivos: no se puede dejar parámetros sin inicializar entre dos parámetros que estén inicializados. Esto permite la invocación de la función sin tener que enviar los valores en las posiciones que corresponden a parámetros inicializados.
-
-**Ejemplos de encabezados de funciones e invocaciones válidas:**
-
-1. **Encabezado:** `int ejemplo(int var1, float var2, int var3 = 10)`
-
-     **Invocaciones:**
-
-    a. `ejemplo(5, 3.3, 12)` Esta invocación asigna el valor 5 a `var1`, el valor 3.3 a `var2`, y el valor 12 a `var3`.
-
-    b. `ejemplo(5, 3.3)`  Esta invocación envía valores para los primeros dos parámetros y el valor del último parámetro será el valor por defecto asignado en el encabezado. Esto es, los valores de las variables en la función serán: `var1` tendrá 5, `var2` tendrá 3.3, y `var3` tendrá 10.
-
-
-2. **Encabezado:** `int ejemplo(int var1, float var2=5.0, int var3 = 10)`
-
-    **Invocaciones:**
-
-    a. `ejemplo(5, 3.3, 12)` Esta invocación asigna el valor 5 a `var1`, el valor 3.3 a `var2`, y el valor 12 a  `var3`.
-
-    b. `ejemplo(5, 3.3)` En esta invocación solo se envían valores para los primeros dos parámetros, y el valor del último parámetro es el valor por defecto.  Esto es, el valor de `var1` dentro de la función será 5, el de `var2` será 3.3 y el de `var3` será 10.
-
-    c. `ejemplo(5)` En esta invocación solo se envía valor para el primer parámetro, y los últimos dos parámetros tienen valores por defecto.  Esto es,  el valor de `var1` dentro de la función será 5, el de `var2` será 5.0 y el de `var3` será 10.
-
-**Ejemplo de un encabezado de funciones válido con invocaciones inválidas:**
-
-1. **Encabezado:** `int ejemplo(int var1, float var2=5.0, int var3 = 10)`
-
-    **Invocación:**
-
-    a. `ejemplo(5, ,10)` Esta invocación  es **inválida** porque   deja espacio vacío en el argumento del medio.
-
-    b. `ejemplo()` Esta invocación es **inválida** ya que `var1` no estaba inicializada y no recibe ningún valor en la invocación.
-
-**Ejemplos de encabezados de funciones inválidos:**
-
-1. `int ejemplo(int var1=1, float var2, int var3)` Este encabezado es inválido porque los valores por defecto solo se pueden asignar comenzando por el parámetro más a la derecha.
-
-2. `int ejemplo(int var1=1, float var2, int var3=10)` Este encabezado es inválido porque no se pueden poner parámetros sin valores en medio de parámetros con valores por defecto. En este caso  `var2` no tiene valor pero `var1` y `var3` si.
-
-
-
----
-
----
-
-## Ecuaciones paramétricas
-
-Las *ecuaciones paramétricas* nos permiten representar una cantidad como función de una o más variables independientes llamadas *parámetros*. En muchas ocasiones resulta útil representar curvas utilizando un conjunto de ecuaciones paramétricas que expresen las coordenadas de los puntos de la curva como funciones de los parámetros. Por ejemplo, en tu curso de trigonometría debes haber estudiado que la ecuación de un círculo con radio $r$ y centro en el origen tiene una forma así:
-
-$$x^2+y^2=r^2.$$
-
-
-Los puntos $(x,y)$ que satisfacen esta ecuación son los puntos que forman el círculo de radio $r$ y centro en el origen.  Por ejemplo, el círculo con $r=2$ y centro en el origen tiene ecuación
-
-$$x^2+y^2=4,$$
-
-y sus puntos son los pares ordenados $(x,y)$ que satisfacen esa ecuación. Una forma paramétrica de expresar las coordenadas de los puntos del círculo con radio $r$ y centro en el origen es:
-
-$$x=r \cos(t)$$
-
-$$y=r \sin(t),$$
-
-donde $t$ es un parámetro que corresponde a la medida (en radianes) del ángulo positivo con lado inicial que coincide con la parte positiva del eje de $x$, y lado terminal que contiene el punto $(x,y)$, como se muestra en la Figura 1.
-
-
----
-
-![circulo.jpg](images/circuloAngulo01.png)
-
-**Figura 1.** Círculo con centro en el origen y radio $r$.
-
-
----
-
-Para graficar una curva que está definida usando ecuaciones paramétricas, computamos los valores de $x$ y $y$ para un conjunto de valores del parámetro. Por ejemplo, la Figura 2 resalta los valores de $t$, $(x,y)$ para el círculo con $r = 2$.
-
----
-
-
-
-![circulo.jpg](images/circuloPuntos01.png)
-
-**Figura 2.** Algunas coordenadas de los puntos $(x,y)$ del círculo con radio $r=2$ y centro en el origen.
-
----
-
----
-
-
-
-!INCLUDE "../../eip-diagnostic/DVD/es/diag-dvd-01.html"
-
-!INCLUDE "../../eip-diagnostic/DVD/es/diag-dvd-03.html"
-
-!INCLUDE "../../eip-diagnostic/DVD/es/diag-dvd-11.html"
-
-!INCLUDE "../../eip-diagnostic/DVD/es/diag-dvd-12.html"
-
----
-
----
-
-
-## Sesión de laboratorio:
-
-En la introducción al tema de funciones viste que, tanto en matemáticas como en algunos lenguajes de programación, una función no puede devolver más de un resultado. En los ejercicios de esta experiencia de laboratorio practicarás cómo usar variables de referencia para poder obtener varios resultados de una función.
-
-### Ejercicio 1
-
-En este ejercicio estudiarás la diferencia entre pase por valor y pase por referencia.
-
-**Instrucciones**
-
-1. Descarga la carpeta `Functions-PrettyPlots` de `Bitbucket` usando un terminal, moviéndote al directorio `Documents/eip`,  y escribiendo el comando `git clone http://bitbucket.org/eip-uprrp/functions-prettyplots`.
-
-2. Carga a Qt Creator el proyecto `prettyPlot`  haciendo doble "click" en el archivo `prettyPlot.pro` que se encuentra en la carpeta `Documents/eip/Functions-PrettyPlots` de tu computadora.
-
-3. Configura el proyecto y ejecuta el programa marcando la flecha verde en el menú de la izquierda de la interface de Qt Creator. El programa debe mostrar una ventana parecida a la Figura 3.
-
-
-    ---
-
-    ![Figura3.png](images/Figura3.png)
-
-    **Figura 3.** Gráfica de un círculo de radio 5 y centro en el origen desplegada por el programa *PrettyPlot*.
-
-    ---
-
-3. Abre el archivo `main.cpp` (en Sources).  Estudia la función `illustration` y su invocación desde la función `main`. Nota que las variables `argValue` y `argRef` están inicializadas a 0 y que la invocación a `illustration` hace un pase por valor de `argValue` y un pase por referencia de `argRef`. Nota también que a los parámetros correspondientes en `illustration` se les asigna el valor 1.
-
-        void illustration(int paramValue, int &paramRef) {
-            paramValue = 1;
-            paramRef = 1;
-            cout << endl << "The content of paramValue is: " << paramValue << endl
-                 << "The content of paramRef is: " << paramRef << endl;
-        }
-
-4. Ejecuta el programa y observa lo que se despliega en la ventana `Application Output`. Nota la diferencia entre el contenido las variables `argValue` y `argRef` a pesar de que ambas tenían el mismo valor inicial y de que a `paramValue` y `paramRef` se les asignó el mismo valor. Explica por qué el contenido de `argValor` no cambia, mientras que el contenido de `argRef` cambia de 0 a 1.
-
-### Ejercicio 2
-
-En este ejercicio practicarás la creación de una función sobrecargada.
-
-**Instrucciones**
-
-1. Estudia el código de la función `main()` del archivo `main.cpp`. La línea `XYPlotWindow wCircleR5;` crea el objeto `wCircleR5` que será la ventana en donde se dibujará una gráfica, en este caso la gráfica de un círculo de radio 5. De manera similar se crean los objetos `wCircle` y `wButterfly`. Observa el ciclo `for`. En este ciclo se genera una serie de valores para el ángulo $t$ y se invoca la función `circle`, pasándole el valor de $t$ y las referencias a $x$ y $y$. La función `circle` no devuelve valor pero, usando parámetros por referencia, calcula valores para las coordenadas $xCoord$ y $yCoord$ del círculo con centro en el origen y radio 5 y permite que la función `main` tenga esos valores en las variables `x` , `y`.
-
-        XYPlotWindow wCircleR5;
-        XYPlotWindow wCircle;
-        XYPlotWindow wButterfly;
-
-        double r;
-        double y = 0.00;
-        double x = 0.00;
-        double increment = 0.01;
-        int argValue=0, argRef=0;
-
-        // invoke the function illustration to view the contents of variables
-        // by value and by reference
-
-            illustration(argValue,argRef);
-            cout << endl << "The content of argValue is: " << argValue << endl
-                 << "The content of argRef is: " << argRef << endl;
-
-        // repeat for several values of the angle t
-        for (double t = 0; t < 16*M_PI; t = t + increment) {
-
-            // invoke circle with the angle t and reference variables x, y as arguments
-            circle(t,x,y);
-
-            // add the point (x,y) to the graph of the circle
-            wCircleR5.AddPointToGraph(x,y);
-
-    Luego de la invocación, cada par ordenado $(x,y)$  es añadido a la gráfica del círculo por el método `AddPointToGraph(x,y)`. Luego del ciclo se invoca el método `Plot()`, que "dibuja" los puntos, y el método `show()`, que muestra la gráfica. Los *métodos* son funciones que nos permiten trabajar con los datos de los objetos. Nota que cada uno de los métodos se escribe luego de `wCircleR5`, seguido de un punto. En una experiencia de laboratorio posterior aprenderás más sobre objetos y practicarás cómo crearlos e invocar sus métodos.
-
-    La función `circle` implementada en el programa es muy restrictiva ya que siempre calcula los valores para las coordenadas $x$ y $y$ del mismo círculo: el círculo con centro en el origen y radio 5.
-
-2. Ahora crearás una función sobrecargada `circle` que reciba como argumentos el valor del ángulo $t$, la referencia a las variables $x$ y $y$, y el valor para el radio del círculo. Invoca desde `main()` la función sobrecargada  `circle` que acabas de implementar para calcular los valores de las coordenadas $x$ y $y$ del círculo con radio 15 y dibujar su gráfica. Grafica el círculo dentro del objeto `wCircle`. Para esto, debes invocar desde `main()` los métodos `AddPointToGraph(x,y)`, `Plot` y `show`. Recuerda que éstos deben ser precedidos por `wCircle`, por ejemplo, `wCircle.show()`.
-
-### Ejercicio 3
-
-En este ejercicio implantarás otra función para calcular las coordenadas de los puntos de la gráfica de una curva.
-
-**Instrucciones**
-
-1. Ahora crearás una función para calcular las coordenadas de los puntos de la gráfica que parece una mariposa. Las ecuaciones paramétricas para las coordenadas de los puntos de la gráfica están dadas por:
-
-    $$x=5\cos(t) \left[ \sin^2(1.2t) + \cos^3(6t) \right]$$
-
-    $$y= 10\sin(t) \left[ \sin^2(1.2t) +  \cos^3(6t) \right].$$
-
-    Observa que ambas expresiones son casi iguales, excepto que una comienza con $5\cos(t)$ y la otra con $10\sin(t)$. En lugar de realizar el cómputo de $ \sin^2(1.2t) + \cos^3(6t)$ dos veces, puedes asignar su valor a otra variable $q$ y realizar el cómputo así:
-
-    $$q =  \sin^2(1.2t) + \cos^3(6t)$$
-
-    $$x = 5 \cos(t)(q)$$
-
-    $$y = 10  \sin(t)(q).$$
-
-2. Implementa la función `butterfly` utilizando las expresiones de arriba, invoca la función desde `main()` y observa la gráfica que resulta. Se supone que parezca una mariposa. Esta gráfica debe haber sido obtenida dentro de un objeto `XYPlotWindow` llamado `wButterfly`, invocando métodos de manera similar a como hiciste en el Ejercicio 2 para el círculo.
-
-En [2] y [3] puedes encontrar otras ecuaciones paramétricas de otras curvas interesantes.
-
-
----
-
----
-
-## Entregas
-
-Utiliza "Entrega" en Moodle para entregar el archivo `main.cpp` que contiene las funciones que implementaste, las invocaciones y  cambios que hiciste en los ejercicios 2 y 3. Recuerda utilizar buenas prácticas de programación, incluir el nombre de los programadores y documentar tu programa.
-
-
-
----
-
----
-
-##Referencias
-
-[1] http://mathbits.com/MathBits/CompSci/functions/UserDef.htm
-
-[2] http://paulbourke.net/geometry/butterfly/
-
-[3] http://en.wikipedia.org/wiki/Parametric_equation
-
----
-
----
-
----
-
-[English](#markdown-header-using-functions-in-c-pretty-plots) | [Español](#markdown-header-utilizando-funciones-en-c-graficas-bonitas)
-
-# Using functions in C++ - Pretty Plots
-
-
-![main2.png](images/main2.png)
-![rsz_mariposa1.png](images/rsz_mariposa1.png)
-![rsz_mariposa.png](images/rsz_mariposa.png)
-
-[version 2016.01.29]
-
-A good way to organize and structure computer programs is dividing them into smaller parts using functions. Each function carries out a specific task of the problem  that we are solving.
-
-You've seen that all programs written in C++ must contain the `main` function where the program begins. You've probably already used functions such as `pow`, `sin`, `cos`, or `sqrt` from the `cmath` library. Since in almost all of the upcoming lab activities you will continue using pre-defined functions, you need to understand how to work with them. In future exercises you will learn how to design and validate functions. In this laboratory experience you will invoke and define functions that compute the coordinates of the points of the graphs of some curves. You will also practice the implementation of arithmetic expressions in C++.
-
-
-## Objectives:
-
-1. Identify the parts of a function: return type, name, list of parameters, and body.
-2. Invoke pre-defined functions by passing arguments by value ("pass by value"), and by reference ("pass by reference").
-3. Implement a simple overloaded function.
-4. Implement a simple function that utilizes parameters by reference.
-5. Implement arithmetic expressions in C++.
-
-## Pre-Lab:
-
-Before you get to the laboratory you should have:
-
-1. Reviewed the following concepts:
-
-    a. the basic elements of a function definition in C++.
-
-    b. how to invoke functions in C++.
-
-    c. the difference between parameters that are passed by value and by reference.
-
-    d. how to return the result of a function.
-
-    e. implement arithmetic expressions in C++.
-
-    f. use functions and arithmetic constants from the `cmath` library.
-
-    g. a circle's graph and equation.
-
-2. Studied the concepts and instructions for the laboratory session.
-
-3. Taken the Pre-Lab quiz that can be found in Moodle.
-
----
-
----
-
-## Functions
-
-In mathematics, a function $f$ is a rule that is used to assign to each element $x$ from a set called *domain*, one (and only one) element $y$ from a set called *range*. This rule is commonly represented with an equation, $y=f(x)$. The variable $x$ is the parameter of the function and the variable $y$ will contain the result of the function. A function can have more than one parameter, but only one result. For example, a  function can have the form $y=f(x_1,x_2)$ where there are two parameters, and for each pair $(a,b)$ that is used as an argument in the function, the function has only one value of $y=f(a,b)$. The domain of the function tells us the type of value that the parameter should have and the range tells us the value that the returned result will have.
-
-Functions in programming languages are similar. A function has a series of instructions that take the assigned values as parameters and performs a certain task. In C++ and other programming languages, functions return only one result, as it happens in mathematics. The only difference is that a *programming* function could possibly not return any value (in this case the function is declared as `void`). If the function will return a value, we use the instruction `return`. As in math, you need to specify the types of values that the function's parameters and result will have; this is done when declaring the function.
-
-### Function header:
-
-The first sentence of a function is called the *header* and its structure is as follows:
-
-`type name(type parameter_1, ..., type parameter_n)`
-
-For example,
-
-`int example(int var1, float var2, char &var3)`
-
-would be the header of the function called `example`, which returns an integer value. The function receives as arguments an integer value (and will store a copy in `var1`), a value of type `float` (and will store a copy in `var2`) and the reference to a variable of type `char` that will be stored in the reference variable `var3`. Note that `var3` has a & symbol before the name of the variable. This indicates that `var3` will contain the reference to a character.
-
-
-### Invoking
-
-
-If we want to store the value of the `example` function's result in a variable `result` (that would be of type integer), we invoke the function by passing arguments as follows:
-
-`result=example(2, 3.5, unCar);`
-
-Note that as the function is invoked, you don't include the type of the variables in the arguments. As in the definition for the function `example`, the third parameter `&var3` is a reference variable; what is being sent to the third argument when invoking the function is a *reference* to the variable `unCar`. Any changes that are made on the variable `var3` will change the contents of the variable `unCar`.
-
-You can also use the function's result without having to store it in a variable. For example you could print it:
-
-`cout << "The result of the function example is:" << example(2, 3.5, unCar);`
-
-or use it in an arithmetic expression:
-
-`y=3 + example(2, 3.5, unCar);`
-
-
-
-### Overloaded functions
-
-Overloaded functions are functions that have the same name, but a different *signature*.
-
-The signature of a function is composed of the name of the function, and the types of parameters it receives, but does not include the return type.
-
-The following function prototypes have the same signature:
-
-```
-int example(int, int) ;
-void example(int, int) ;
-string example(int, int) ;
-```
-
-
-Note that each has the same name, `example`, and receives the same amount of parameters of the same type `(int, int)`.
-
-The following function prototypes have different signatures:
-
-```
-int example(int) ;
-int elpmaxe(int) ;
-```
-
-Note that even though the functions have the same amount of parameters with the same type `int`, the name of the functions is different.
-
-The following function prototypes are overloaded versions of the function `example`:
-
-```
-int example(int) ;
-void example(char) ;
-int example(int, int) ;
-int example(char, int) ;
-int example(int, char) ;
-```
-
-All of the above functions have the same name, `example`, but different parameters. The first and second functions have the same amount of parameters, but their arguments are of different types. The fourth and fifth functions have arguments of type `char` and `int`, but in each case are in different order.
-
-In that last example, the function `example` is overloaded since there are 5 functions with different signatures but with the same name.
-
-
-
-### Values by default
-
-Values by default can be assigned to the parameters of the functions starting from the first parameter to the right. It is not necessary to initialize all of the parameters, but the ones that are initialized should be consecutive: parameters in between two parameters cannot be left uninitialized. This allows calling the function without having to send values in the positions that correspond to the initialized parameters.
-
-**Examples of function headers and valid invocations:**
-
-1. **Headers:** `int example(int var1, float var2, int var3 = 10)`
-
-    **Invocations:**
-
-    a. `example(5, 3.3, 12)` This function call assigns the value 5 to `var1`, the value 3.3 to `var2`, and the value of 12 to `var3`.
-
-    b. `example(5, 3.3)` This function call sends the values for the first two parameters and the value for the last parameter will be the value assigned by default in the header. That is, the values in the variables in the function will be as follows: `var1` will be 5, `var2` will be 3.3, and `var3` will be 10.
-
-2. **Header:** `int example(int var1, float var2=5.0, int var3 = 10)`
-
-    **Invocations:**
-
-    a. `example(5, 3.3, 12)` This function call assigns the value 5 to `var1`, the value 3.3 to `var2`, and the value 12 to `var3`.
-
-    b. `example(5, 3.3)` In this function call only the first two parameters are given values, and the value for the last parameter is the value by default. That is, the value for `var1` within the function will be 5, that of `var2` will be 3.3, and `var3` will be 10.
-
-    c. `example(5)` In this function call only the first parameter is given a value, and the last two parameters will be assigned  values by default. That is, `var1` will be 5, `var2` will be 5.0, and `var3` will be 10.
-
-
-**Example of a valid function header with invalid invocations:**
-
-1. **Header:** `int example(int var1, float var2=5.0, int var3 = 10)`
-
-    **Invocation:**
-
-    a. `example(5, , 10)` This function call is **invalid** because it leaves an empty space in the middle argument.
-
-    b. `example()` This function call is **invalid** because `var1` was not assigned a default value. A valid invocation to the function `example` needs at least one argument (the first).
-
-
-**Examples of invalid function headers:**
-
-1. `int example(int var1=1, float var2, int var3)` This header is invalid because  the  default values can only be assigned starting from the rightmost parameter.
-
-2. `int example(int var1=1, float var2, int var3=10)` This header is invalid because you can't place parameters without values between other parameters with default values. In this case, `var2` doesn't have a default value but `var1` and `var3` do.
-
-
----
-
----
-
-## Parametric equations
-
-*Parametric equations* allow us to represent a quantity as a function of one or more independent variables called *parameters*. In many occasions it is useful to represent curves using a set of parametric equations that express the coordinates of the points of the curve as functions of the parameters. For example, in your trigonometry course you should have studied that the equation of the circle of radius $r$ and centered at the origin has the following form:
-
-
-$$x^2+y^2=r^2.$$
-
-The points $(x,y)$ that satisfy this equation are the points that form the circle of radius $r$ and center at the origin. For example, the circle with $r=2$ and center at the origin has equation
-
-
-$$x^2+y^2=4,$$
-
-and its points are the ordered pairs $(x,y)$ that satisfy this equation. A parametric representation of the coordinates of the points in the circle of radius $r$ and center at the origin is:
-
-
-$$x=r \cos(t)$$
-
-$$y=r \sin(t),$$
-
-where $t$ is a parameter that corresponds to the measure (in radians) of the positive angle  with initial side that coincides with the positive part of the $x$-axis and terminal side that contains the point $(x,y)$, as it is illustrated in Figure 1.
-
-
----
-
-![circulo.jpg](images/circuloAngulo01.png)
-
-**Figure 1.** Circle with center in the origin and radius $r$.
-
-
----
-
-To plot a curve that is described  by parametric equations, we compute the $x$ and $y$ values for a set of values of the parameter. For example, for $r=2$, some of the values are
-
-
----
-
-![circulo.jpg](images/circuloPuntos01.png)
-
-**Figure 2.** Some coordinates for the points $(x,y)$ for the circle with radius $r=2$ and center in the origin.
-
----
-
----
-
-## Laboratory session:
-
-In the introduction to the topic of functions you saw that in mathematics and in some programming languages, a function cannot return more than one result. In this laboratory experience's exercises you will practice how to use reference variables to obtain various results from a function.
-
-### Exercise 1
-
-In this exercise you will study the difference between pass by value and pass by reference.
-
-**Instructions**
-
-1. Load the project `prettyPlot` in Qt by double clicking on the file `prettyPlot.pro` in the folder `Documents/eip/Functions-PrettyPlots` of your computer. You may also go to `http://bitbucket.org/eip-uprrp/functions-prettyplots` to download the folder `Functions-PrettyPlots` to your computer.
-
-2. Configure the project and execute the program by clicking on the green arrow in the menu on the left side of the Qt Creator screen. The program should show a window similar to the one in Figure 3.
-
-    ---
-
-    ![Figura3.png](images/Figura3.png)
-
-    **Figure 3.**  Graph of a circle with radius 5 and center in the origin displayed by the program *PrettyPlot*.
-
-    ---
-
-3. Open the file `main.cpp` (in Sources). Study the `illustration` function and how to call it from the `main` function. Note that the variables `argValue` and `argRef`are initialized to 0 and that the function call for `illustration` makes a pass by value of `argValue` and a pass by reference of `argRef`. Also note that the corresponding parameters in `illustration` are assigned a value of 1.
-
-        void illustration(int paramValue, int &paramRef) {
-            paramValue = 1;
-            paramRef = 1;
-            cout << endl << "The content of paramValue is: " << paramValue << endl
-                 << "The content of paramRef is: " << paramRef << endl;
-        }
-
-4. Execute the program and observe what is displayed in the window `Application Output`. Notice the difference between the content of the variables `argValue` and `argRef` despite the fact that both had the same initial value, and that `paramValue` and `paramRef` were assigned the same value. Explain why the content of `argValor` does not change, while the content of `argRef` changes from 0 to 1.
-
-### Exercise 2
-
-In this exercise you will practice the creation of an overloaded function.
-
-**Instructions**
-
-1. Study the code in the `main()` function in the file `main.cpp`.
-
-        XYPlotWindow wCircleR5;
-        XYPlotWindow wCircle;
-        XYPlotWindow wButterfly;
-
-        double r;
-        double y = 0.00;
-        double x = 0.00;
-        double increment = 0.01;
-        int argValue=0, argRef=0;
-
-        // invoke the function illustration to view the contents of variables
-        // by value and by reference
-
-            illustration(argValue,argRef);
-            cout << endl << "The content of argValue is: " << argValue << endl
-                 << "The content of argRef is: " << argRef << endl;
-
-        // repeat for several values of the angle t
-        for (double t = 0; t < 16*M_PI; t = t + increment) {
-
-            // invoke circle with the angle t and reference variables x, y as arguments
-            circle(t,x,y);
-
-            // add the point (x,y) to the graph of the circle
-            wCircleR5.AddPointToGraph(x,y);
-
-    The line `XYPlotWindow wCircleR5;` creates a `wCircleR5` object that will be the window where the graph will be drawn, in this case the graph of a circle of radius 5. In a similar way, the objects `wCircle` and `wButterfly` are created. Observe the `for` cycle. In this cycle a series of values for the angle $t$ is generated and the function `circle` is invoked, passing the value for $t$ and the references to $x$ and $y$. The `circle` function does not return a value, but using parameters by reference, it calculates the values for the coordinates $xCoord$ and $yCoord$ for the circle with center in the origin and radius 5, and allows the `main` function  to have these values in the `x` , `y` variables.
-
-    After the function call, each ordered pair $(x,y)$ is added to the circle’s graph by the member function `AddPointToGraph(x,y)`. After the cycle, the member function `Plot()` is invoked, which draws the points, and the member function `show()`, which displays the graph. The *members functions* are functions that allow use to work with and object’s data. Notice that each one of the member functions is written after `wCircleR5`, followed by a period. In an upcoming laboratory experience you will learn more about objects, and practice how to create them and invoke their method functions.
-
-    The `circle` function implemented in the program is very restrictive since it always calculates the values for the coordinates $x$ and $y$ of the same circle: the circle with center in the origin and radius 5.
-
-2. Now you will create an overloaded function `circle` that receives as arguments the value of the angle $t$, the reference to the variables $x$ and $y$, and the value for the radius of the circle. Invoke the overloaded function `circle` that you just implemented from `main()` to calculate the values of the coordinates $x$ and $y$ for the circle with radius 15 and draw its graph. Graph the circle within the `wCircle` object. To do this, you must invoke the method functions `AddPointToGraph(x,y)`, `Plot` and `show` from `main()`. Remember that these should be preceded by `wCircle`, for example, `wCircle.show()`.
-
-### Exercise 3
-
-In this exercise you will implement another function to calculate the coordinates of the points in the graph of a curve.
-
-**Instructions**
-
-1. Now you will create a function to calculate the coordinates of the points of a graph that resembles a butterfly. The parametric equations for the coordinates of the points in the graph are given by:
-
-    $$x=5\cos(t) \left[ \sin^2(1.2t) + \cos^3(6t) \right]$$
-
-    $$y= 10\sin(t) \left[ \sin^2(1.2t) +  \cos^3(6t) \right].$$
-
-    Observe that both expressions are almost the same, except that one starts with $5\cos(t)$ and the other with $10\sin(t)$. Instead of doing the calculation for $ \sin^2(1.2t) + \cos^3(6t)$ twice, you can assign its value to another variable $q$ and calculate it as such:
-
-    $$q =  \sin^2(1.2t) + \cos^3(6t)$$
-
-    $$x = 5 \cos(t)(q)$$
-
-    $$y = 10  \sin(t)(q).$$
-
-2. Implement the function `butterfly` using the expressions above, invoke the function in `main()` and observe the resulting graph. It is supposed to look like a butterfly. This graph should have been obtained with a `XYPlotWindow` object called `wButterfly`, invoking method functions similar to how you did in Exercise 2 for the circle.
-
-In [2] and [3] you can find other parametric equations from other interesting curves.
-
----
----
-
-##Deliverables
-
-Use "Deliverables" in Moodle to hand in the file `main()` that contains the functions you implemented, the function calls and changes you made in exercises 2 and 3. Remember to use good programming techniques, include the name of the programmers involved and document your program.
-
-
----
-
----
-
-##References
-
-[1] http://mathbits.com/MathBits/CompSci/functions/UserDef.htm
-
-[2] http://paulbourke.net/geometry/butterfly/
-
-[3] http://en.wikipedia.org/wiki/Parametric_equation
+## [\[English\]](README-en.md) - for README in English
+## [\[Spanish\]](README-es.md) - for README in Spanish