Plot Basic tutorial/es: Difference between revisions

From FreeCAD Documentation
(Created page with "Comenzaremos seleccionando la primera serie, para la cuál desmarcaremos la casilla '''No label''', lo que hará que aparezca la serie en la legenda, y nos permitirá establec...")
No edit summary
(24 intermediate revisions by 3 users not shown)
Line 1: Line 1:
<languages/>
En este tutorial vamos a aprender a crear gráficos usando el módulo de graficado y la consola Python. Puedes aprender más sobre el [[Plot_Module/es|módulo de graficado aquí]].

<div class="mw-translate-fuzzy">
{{TutorialInfo/es
|Topic=Plot Workbench
|Level=Beginner
|Time=
|Author=
|FCVersion=
|Files=
}}
</div>

<div class="mw-translate-fuzzy">
En este tutorial vamos a aprender a crear gráficos usando el módulo de graficado y la consola Python. Puedes aprender más sobre el [[Plot_Workbench/es|módulo de graficado aquí]].
</div>


[[Image:Plot_Trigonometric_Example.png|600px]]
<div class="mw-translate-fuzzy">
[[Image:Plot_Trigonometric_Example.png|600px|center|Ejemplo de gráfico]]
[[Image:Plot_Trigonometric_Example.png|600px|center|Ejemplo de gráfico]]
<center><span style="font-variant:small-caps">Ejemplo de gráfico.</span></center>
<center><span style="font-variant:small-caps">Ejemplo de gráfico.</span></center>
</div>


<div class="mw-translate-fuzzy">
En la imagen anterior puedes ver una muestra del gráfico que pretendemos generar. Mediante este tutorial aprenderás:
En la imagen anterior puedes ver una muestra del gráfico que pretendemos generar. Mediante este tutorial aprenderás:


Line 14: Line 33:
* A configurar la apariencia de las series.
* A configurar la apariencia de las series.
* A guardar el gráfico como archivo de imagen.
* A guardar el gráfico como archivo de imagen.
</div>


==Plotting data==

<div class="mw-translate-fuzzy">
==Graficar==
==Graficar==


El módulo de graficado no necesita de ningún documento de FreeCAD para poder comenzar a trabajar, simplemente despliega la consola de Python, o genera los [[Macros/es|macros]] oportunos y comienza a trabajar.
El módulo de graficado no necesita de ningún documento de FreeCAD para poder comenzar a trabajar, simplemente despliega la consola de Python, o genera los [[Macros/es|macros]] oportunos y comienza a trabajar.
</div>

===Creating plot document===


<div class="mw-translate-fuzzy">
===Crear un documento de gráfico===
===Crear un documento de gráfico===


Line 25: Line 52:
* Puedes elegir la etiqueta de la ventana.
* Puedes elegir la etiqueta de la ventana.
* Puedes controlar facilmente en que documento se trazan los gráficos.
* Puedes controlar facilmente en que documento se trazan los gráficos.
</div>


<div class="mw-translate-fuzzy">
Para crear un documento de gráfico nuevo simplemente lanza los siguientes comandos desde la terminal:
Para crear un documento de gráfico nuevo simplemente lanza los siguientes comandos desde la terminal:
</div>
<syntaxhighlight>

import Plot
{{Code|code=
Plot.figure("TrigonometricTest")
try:
</syntaxhighlight>
from FreeCAD.Plot import Plot
except ImportError:
from freecad.plot import Plot

Plot.figure("TrigonometricTest")
}}

<div class="mw-translate-fuzzy">
Esto creará un nuevo documento llamado '''TrigonometricTest'''. Éste nuevo documento ya contiene unos ejes. Cada documento de gráfico debe tener al menos un set de ejes que no se podrá borrar a menos que se entre en profundidad en la interfaz matplotlib.
Esto creará un nuevo documento llamado '''TrigonometricTest'''. Éste nuevo documento ya contiene unos ejes. Cada documento de gráfico debe tener al menos un set de ejes que no se podrá borrar a menos que se entre en profundidad en la interfaz matplotlib.
</div>

===Drawing functions===


<div class="mw-translate-fuzzy">
===Trazar curvas===
===Trazar curvas===


Line 38: Line 79:


Lo primero que necesitamos para trazar las curvas es generar los datos:
Lo primero que necesitamos para trazar las curvas es generar los datos:
</div>
<syntaxhighlight>

import math
{{Code|code=
t = range(0,101)
import math
t = [tt/100.0 for tt in t]
t = range(0,101)
s = [math.sin(2.0*math.pi*tt) for tt in t]
c = [math.cos(2.0*math.pi*tt) for tt in t]
t = [tt/100.0 for tt in t]
s = [math.sin(2.0*math.pi*tt) for tt in t]
</syntaxhighlight>
c = [math.cos(2.0*math.pi*tt) for tt in t]
}}

Lo que creará tres vectores (con 101 puntos):
Lo que creará tres vectores (con 101 puntos):


Line 51: Line 95:
* ''c'' = Función coseno.
* ''c'' = Función coseno.


<div class="mw-translate-fuzzy">
Para trazar las curvas correspondientes tan sólo será necesario lanzar los siguientes comandos:
Para trazar las curvas correspondientes tan sólo será necesario lanzar los siguientes comandos:
</div>
<syntaxhighlight>

Plot.plot(t,s)
{{Code|code=
Plot.plot(t,c)
Plot.plot(t,s)
</syntaxhighlight>
Plot.plot(t,c)
}}

<div class="mw-translate-fuzzy">
Lo que graficará los datos. El comando '''plot''' admite que se le pase el título de la serie como tercer argumento, no obstante como vamos a editar manualmente esos datos optaremos por no emplear esta propiedad.
Lo que graficará los datos. El comando '''plot''' admite que se le pase el título de la serie como tercer argumento, no obstante como vamos a editar manualmente esos datos optaremos por no emplear esta propiedad.
</div>


==Configuración del gráfico==
==Configuración del gráfico==


===Showing grid and legend===

<div class="mw-translate-fuzzy">
===Mostrar la malla y la legenda===
===Mostrar la malla y la legenda===


Cambie al [[Plot_Module|módulo de graficado]] mediante el menú Ver/Escenario. Cuando haya cargado el módulo podrá emplear la herramienta de mostrado/ocultado de la malla para mostrar la malla.
Cambie al [[Plot_Workbench|módulo de graficado]] mediante el menú Ver/Escenario. Cuando haya cargado el módulo podrá emplear la herramienta de mostrado/ocultado de la malla para mostrar la malla.
</div>


[[Image:Plot_Grid.svg‎]]
<div class="mw-translate-fuzzy">
[[Image:Plot_Grid.png‎|center|Icono de la herramienta para mostrar/ocultar la malla]]
[[Image:Plot_Grid.png‎|center|Icono de la herramienta para mostrar/ocultar la malla]]
<center><span style="font-variant:small-caps">Icono de la herramienta para mostrar/ocultar la malla.</span></center>
<center><span style="font-variant:small-caps">Icono de la herramienta para mostrar/ocultar la malla.</span></center>
</div>


<div class="mw-translate-fuzzy">
Volviendo a presionar sobre el botón se vuelve a ocultar la malla. De la misma forma usted puede mostrar la legenda mediante la herramienta correspondiente.
Volviendo a presionar sobre el botón se vuelve a ocultar la malla. De la misma forma usted puede mostrar la legenda mediante la herramienta correspondiente.
</div>


[[Image:Plot_Legend.svg]]
<div class="mw-translate-fuzzy">
[[Image:Plot_Legend.png‎|center|Icono de la herramienta para mostrar/ocultar la legenda]]
[[Image:Plot_Legend.png‎|center|Icono de la herramienta para mostrar/ocultar la legenda]]
<center><span style="font-variant:small-caps">Icono de la herramienta para mostrar/ocultar la legenda.</span></center>
<center><span style="font-variant:small-caps">Icono de la herramienta para mostrar/ocultar la legenda.</span></center>
</div>


<div class="mw-translate-fuzzy">
Como observará la legenda está vacía debido a que las series no tienen asignado un título todavía. En el [[Plot_Module|módulo de graficado]] las series sin título asignado no son consideradas por la legenda, permitiendo crear líneas auxiliares dentro del gráfico.
Como observará la legenda está vacía debido a que las series no tienen asignado un título todavía. En el [[Plot_Workbench|módulo de graficado]] las series sin título asignado no son consideradas por la legenda, permitiendo crear líneas auxiliares dentro del gráfico.
</div>


===Setting series label===

<div class="mw-translate-fuzzy">
===Establecer los títulos de las series===
===Establecer los títulos de las series===


Con la herrameitna de edición de series usted puede editar algunos parámetros de las curvas trazadas.
Con la herrameitna de edición de series usted puede editar algunos parámetros de las curvas trazadas.
</div>


[[Image:Plot_Series.svg‎]]
<div class="mw-translate-fuzzy">
[[Image:Plot_Series.png‎|center|Icono de la herramienta de edición de series]]
[[Image:Plot_Series.png‎|center|Icono de la herramienta de edición de series]]
<center><span style="font-variant:small-caps">Icono de la herramienta de edición de series.</span></center>
<center><span style="font-variant:small-caps">Icono de la herramienta de edición de series.</span></center>
</div>


<div class="mw-translate-fuzzy">
Comenzaremos seleccionando la primera serie, para la cuál desmarcaremos la casilla '''No label''', lo que hará que aparezca la serie en la legenda, y nos permitirá establecer el siguiente título:
Comenzaremos seleccionando la primera serie, para la cuál desmarcaremos la casilla '''No label''', lo que hará que aparezca la serie en la legenda, y nos permitirá establecer el siguiente título:
</div>
<syntaxhighlight>

$y = \sin \left( 2 \pi t \right)$
{{Code|code=
</syntaxhighlight>
$y = \sin \left( 2 \pi t \right)$
Since [http://matplotlib.org/ matplotlib] supports [http://www.latex-project.org LaTeX] you can set all the labels or titles that you want using it. Set the following label to second serie:
}}
<syntaxhighlight>

$y = \cos \left( 2 \pi t \right)$
<div class="mw-translate-fuzzy">
</syntaxhighlight>
Al estar [http://www.latex-project.org LaTeX] soportado por [http://matplotlib.org matplotlib] usted siempre podrá establecer los titulos y etiqutas haciendo uso de él. Establezca el siguiente título para la función coseno:
</div>

{{Code|code=
$y = \cos \left( 2 \pi t \right)$
}}

===Setting series style===
===Setting series style===

Series allows you to set a lot of series properties. Try to set the properties shown at the example image, changing series colors and drawing style of the second one.
<div class="mw-translate-fuzzy">
===Configurar la apariencia de las series===

Usted puede, con la misma herramienta, cambiar algunas propiedades del aspecto visual de sus curvas. Intente configurarlas como las de la imagen de ejemplo cambiando el color y el estilo de la línea.
</div>


===Setting axes labels===
===Setting axes labels===
With the labels tool you can set labels associated to all created axes.


<div class="mw-translate-fuzzy">
[[Image:Plot_Labels.png‎|center|Labels tool icon]]
===Configurar los títulos de los ejes===
<center><span style="font-variant:small-caps">Labels tool icon.</span></center>

Con la herramienta de configuración de títulos usted puede establecer las etiquetas asociadas con cada set de ejes.
</div>

[[Image:Plot_Labels.svg‎]]
<div class="mw-translate-fuzzy">
[[Image:Plot_Labels.png‎|center|Icono de la herramienta de configuración de títulos]]
<center><span style="font-variant:small-caps">Icono de la herramienta de configuración de títulos.</span></center>
</div>

Establezca los siguientes títulos:


Set this data:
* Title = Trigonometric functions example
* Title = Trigonometric functions example
* X Label = $t$
* X Label = $t$
* Y Label = $y = \mathrm{f} \left( t \right)$
* Y Label = $y = \mathrm{f} \left( t \right)$


<div class="mw-translate-fuzzy">
Also change the size of all of them to 20.
Cambie también sus tamaños a 20.
</div>


==Saving plot==
==Saving plot==
With saving plot tool you can save your plot as image file in several formats.


<div class="mw-translate-fuzzy">
[[Image:Plot_Save.png‎|center|Save tool icon]]
==Guardando la imagen==
<center><span style="font-variant:small-caps">Save tool icon.</span></center>


Con la herramienta de salvado usted podrá guardar su trabajo en diferentes formatos.
First for all select the path of the output file. You can use file selection dialog using the button at right of the path edition line.
</div>


[[Image:Plot_Save.svg]]
You can set the output image size in inches, for example we can set 11.7x8.3 that is a '''DIN A4''' paper size. DPI (Dots per inch) will control the image resolution, for example using 100 dpi you will get an image of 1170x830 pixels.
<div class="mw-translate-fuzzy">
[[Image:Plot_Save.png‎|center|Icono de la herramienta de guardado]]
<center><span style="font-variant:small-caps">Icono de la herramienta de guardado.</span></center>
</div>


<div class="mw-translate-fuzzy">
[[Category:Tutorials]]
Lo primero de todo seleccione el archivo donde desea guardar la imagen. Puede usted ayudarse del selector de archivo que se despliega cuando se presiona el botón a la derecha del editor de ruta.
</div>


<div class="mw-translate-fuzzy">
{{clear}}
También puede seleccionar el tamaño de la imagen de salida en pulgadas, por ejemplo puede elegir 11.7x8.3 correspondiente a un '''DIN A4'''. El parámetro DPI (puntos por pulgada) permite controlar la resolución de la imagen, por ejemplo 100 dpi creará una imagen de 1170x830 pixels.
<languages/>
</div>


{{Tutorials_navi{{#translation:}}}}
{{Plot_Tools_navi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}
[[Category:External_Workbenches{{#translation:}}]]
[[Category:Addons{{#translation:}}]]

Revision as of 19:16, 2 October 2021

Tutorial
Tema
Plot Workbench
Nivel
Beginner
Tiempo para completar
Autores
Versión de FreeCAD
Archivos de ejemplos
Ver también
None

En este tutorial vamos a aprender a crear gráficos usando el módulo de graficado y la consola Python. Puedes aprender más sobre el módulo de graficado aquí.

Ejemplo de gráfico
Ejemplo de gráfico
Ejemplo de gráfico.

En la imagen anterior puedes ver una muestra del gráfico que pretendemos generar. Mediante este tutorial aprenderás:

  • A crear un documento de gráfico mediante la consola de Python.
  • A graficar series de datos mediante la consola de Python.
  • A mostrar la malla.
  • A mostrar la legenda.
  • A configurar los títulos de las series usando LaTeX.
  • A configurar los títulos de los ejes usando LaTeX.
  • A configurar la apariencia de las series.
  • A guardar el gráfico como archivo de imagen.

Plotting data

Graficar

El módulo de graficado no necesita de ningún documento de FreeCAD para poder comenzar a trabajar, simplemente despliega la consola de Python, o genera los macros oportunos y comienza a trabajar.

Creating plot document

Crear un documento de gráfico

Los gráficos son documentos especiales dentro de FreeCAD, y pueden ser creados bien manualmente, bien automáticamente cuando se pretende trazar graficos y todavía no existe un documento activo. Crear manualmente los gráficos tiene dos ventajas:

  • Puedes elegir la etiqueta de la ventana.
  • Puedes controlar facilmente en que documento se trazan los gráficos.

Para crear un documento de gráfico nuevo simplemente lanza los siguientes comandos desde la terminal:

try:
    from FreeCAD.Plot import Plot
except ImportError:
    from freecad.plot import Plot

Plot.figure("TrigonometricTest")

Esto creará un nuevo documento llamado TrigonometricTest. Éste nuevo documento ya contiene unos ejes. Cada documento de gráfico debe tener al menos un set de ejes que no se podrá borrar a menos que se entre en profundidad en la interfaz matplotlib.

Drawing functions

Trazar curvas

Usted podría haber comenzado su trabajo en este punto, pues cuando se solicita al módulo de graficado que traze una curva sin existir un documento apropiado, el módulo genera uno nuevo, no obstante todos los consiguientes trazados se incluirán en el mismo documento hasta que se cree uno nuevo. Por esta razón es buena idea siempre tener controlado el número de documentos.

Lo primero que necesitamos para trazar las curvas es generar los datos:

import math
t = range(0,101)
t = [tt/100.0 for tt in t]
s = [math.sin(2.0*math.pi*tt) for tt in t]
c = [math.cos(2.0*math.pi*tt) for tt in t]

Lo que creará tres vectores (con 101 puntos):

  • t = Tiempo en segundos.
  • s = Función seno.
  • c = Función coseno.

Para trazar las curvas correspondientes tan sólo será necesario lanzar los siguientes comandos:

Plot.plot(t,s)
Plot.plot(t,c)

Lo que graficará los datos. El comando plot admite que se le pase el título de la serie como tercer argumento, no obstante como vamos a editar manualmente esos datos optaremos por no emplear esta propiedad.

Configuración del gráfico

Showing grid and legend

Mostrar la malla y la legenda

Cambie al módulo de graficado mediante el menú Ver/Escenario. Cuando haya cargado el módulo podrá emplear la herramienta de mostrado/ocultado de la malla para mostrar la malla.

Icono de la herramienta para mostrar/ocultar la malla
Icono de la herramienta para mostrar/ocultar la malla
Icono de la herramienta para mostrar/ocultar la malla.

Volviendo a presionar sobre el botón se vuelve a ocultar la malla. De la misma forma usted puede mostrar la legenda mediante la herramienta correspondiente.

Icono de la herramienta para mostrar/ocultar la legenda
Icono de la herramienta para mostrar/ocultar la legenda
Icono de la herramienta para mostrar/ocultar la legenda.

Como observará la legenda está vacía debido a que las series no tienen asignado un título todavía. En el módulo de graficado las series sin título asignado no son consideradas por la legenda, permitiendo crear líneas auxiliares dentro del gráfico.

Setting series label

Establecer los títulos de las series

Con la herrameitna de edición de series usted puede editar algunos parámetros de las curvas trazadas.

Icono de la herramienta de edición de series
Icono de la herramienta de edición de series
Icono de la herramienta de edición de series.

Comenzaremos seleccionando la primera serie, para la cuál desmarcaremos la casilla No label, lo que hará que aparezca la serie en la legenda, y nos permitirá establecer el siguiente título:

$y = \sin \left( 2 \pi t \right)$

Al estar LaTeX soportado por matplotlib usted siempre podrá establecer los titulos y etiqutas haciendo uso de él. Establezca el siguiente título para la función coseno:

$y = \cos \left( 2 \pi t \right)$

Setting series style

Configurar la apariencia de las series

Usted puede, con la misma herramienta, cambiar algunas propiedades del aspecto visual de sus curvas. Intente configurarlas como las de la imagen de ejemplo cambiando el color y el estilo de la línea.

Setting axes labels

Configurar los títulos de los ejes

Con la herramienta de configuración de títulos usted puede establecer las etiquetas asociadas con cada set de ejes.

Icono de la herramienta de configuración de títulos
Icono de la herramienta de configuración de títulos
Icono de la herramienta de configuración de títulos.

Establezca los siguientes títulos:

  • Title = Trigonometric functions example
  • X Label = $t$
  • Y Label = $y = \mathrm{f} \left( t \right)$

Cambie también sus tamaños a 20.

Saving plot

Guardando la imagen

Con la herramienta de salvado usted podrá guardar su trabajo en diferentes formatos.

Icono de la herramienta de guardado
Icono de la herramienta de guardado
Icono de la herramienta de guardado.

Lo primero de todo seleccione el archivo donde desea guardar la imagen. Puede usted ayudarse del selector de archivo que se despliega cuando se presiona el botón a la derecha del editor de ruta.

También puede seleccionar el tamaño de la imagen de salida en pulgadas, por ejemplo puede elegir 11.7x8.3 correspondiente a un DIN A4. El parámetro DPI (puntos por pulgada) permite controlar la resolución de la imagen, por ejemplo 100 dpi creará una imagen de 1170x830 pixels.


Template:Tutorials navi/es