Representación y documentación de funciones

Presentación en aula el día 30 de septiembre.
Se define estándar de documentación de funciones y representación gráfica en diagrama de flujo.

Ejercicio de función realizado en clase.

#Objetivo: programar una funcion

#          para calcular los datos y

#          graficar un circulo

#          Realizado en la sala

# aporte: Juan D. Paniagua

# aporte: Jorge Vega

# aporte: Luis Miguel Tobon

# fecha: 2015-10-05 (Lunes)

import numpy as np

import matplotlib.pylab as pl

import math

def circulo(R=1.0,N=20, g='s'):

     """ R(numero),N(entero),g(str) -> X(lista),Y(lista)

         R: Radio del circulo que genera

         N: numero de puntos para grafico

         g: variable que define si grafica

         La funcion calcula los puntos para graficar un

         circulo, los retorna en las listas X, Y. Y grafica

         el circulo usando el modulo Matplotlib.

         fecha: 2015-octubre-05 lunes

         Autor: Juan, Jorge y Luis

         >>>circulo(1,3)

          grafica un triangulo

          

     """

                        

     X=[]

     Y=[]

     T=[0]

     t=0

     delta = (2*math.pi/N)

     while t <= 2*math.pi:

          T.append(t)

          t += delta

     for i in T:

          a= R*math.sin(i)

          Y.append(a)

          b= R*math.cos(i)

          X.append(b)

     if g == 's':

          pl.plot(X,Y)

          pl.xlabel('eje x')

          pl.ylabel('eje y')

          pl.grid('on')

          pl.show()

     

     return X,Y

#Codigo principal