Tutorial de Python
Descripción |
Tema |
Función de ejemplo |
Llamada de función |
|---|---|---|---|
Funciones de programación de bajo nivel |
abrir un archivo |
open(archivo, modo=”r”) |
|
constantes físicas con unidades |
El número de Avogadro |
u.avogadro_number |
|
Unidades que pueden acoplarse a números y matrices numpy |
|
5* u.mm/u.s |
|
aguaclara.core. psico |
Flujo de tuberías, orificios, viscosidad del agua, presas, colectores, ecuación de Kozeny |
total head loss in a straight pipe |
Pérdida de carga (Caudal, Diámetro, Longitud, Nu, TubeRough, KMinor) |
aguaclara.research. floc_model |
Modelo de floculación de AguaClara, gradientes de velocidad, escalas de longitud de Kolmogorov |
Gradiente de velocidad en un tubo enrollado |
g_coil(FlowPlant, IDTube, RadiusCoil, Temp) |
aguaclara.research. environmental_processes_analysis |
|
extraer datos del archivo de análisis Gran generado por ProCoDA |
Gran(data_file_path) |
aguaclara.research. procoda_parser |
Extrae datos de múltiples archivos ProCoDA basándose en la columna de estado y datos |
extraer una columna de datos de un archivo de datos ProCoDA |
column_of_data (data_file_path, inicio, columna) |
Cálculo numérico de integrales, resolución de ecuaciones diferenciales, optimización y matrices dispersas |
Búsqueda de raíces |
raíz(función, 0.3) |
|
Manipulación de matrices y funciones matemáticas |
crear un array con elementos linealmente espaciados |
NP. Linspace (inicio, detención, num) |
|
¡Gráficos! |
Crea gráficos bonitos |
ver más abajo |
Extractos de importación
import aguaclara as ac
from aguaclara.core.units import unit_registry as u
import numpy as np
import matplotlib.pyplot as plt
import pandas as pd
from scipy import constants, interpolate
Consejo: Si estás escribiendo el nombre de una función y quieres saber cuáles son las opciones para completar lo que estás escribiendo, solo tienes que pulsar la tecla tab para un menú de opciones.
Consejo: Si quieres ver el código fuente asociado a una función, puedes hacer la siguiente importación inspect inspect.getsource(foo)
Donde «foo» es la función que te gustaría conocer.
Descuento
Markdown te permite mezclar código, preciosas ecuaciones Latex, texto bien formateado, figuras y tablas.
Markdown no gestiona la numeración automática de ecuaciones, figuras y tablas.
El kernel de Python recuerda todas las definiciones (funciones y variables) tal como se definen según la ejecución. Así, si no ejecutas una línea de código, los parámetros definidos en esa línea no estarán disponibles. De manera similar, si defines un parámetro y luego eliminas esa línea de código, ese parámetro permanece definido hasta que reinicies todos los tiempos de ejecución o reinicies.
Antes de enviar un archivo para que otros lo usen, necesitas verificar que todas las dependencias estén definidas y que no hayas eliminado accidentalmente una definición que es necesaria. Puedes hacerlo reiniciando todos los tiempos de ejecución (menú de tiempo de ejecución) y luego ejecutándolos todos.
Transición de Matlab a Python
Sangría - Al escribir funciones o usar sentencias, Python reconoce bloques de código por la forma en que están sangrados. Un bloque de código es un grupo de sentencias que, juntas, realizan una tarea. Un bloque comienza con una cabecera seguida de una o más sentencias que están sangradas respecto a la cabecera. La sangría indica al intérprete de Python y a los programadores que leen el código, que las sentencias sangradas y el encabezado anterior forman un bloque de código.
Suprimir sentencias - A diferencia de Matlab, no necesitas punto y coma para suprimir una sentencia en Python;
Indexación - Matlab comienza en el índice 1 mientras que Python empieza en el índice 0.
Funciones - En Matlab, las funciones se escriben invocando la palabra clave «function», el(los) parámetro(s) de retorno, el igual a signo, el nombre de la función y los parámetros de entrada. Una función termina con «end».:
function
y = average(x)
if ~isvector(x)
error('Input must be a vector') end
y = sum(x)/length(x);
end
En Python, las funciones pueden escribirse usando la palabra clave «def», seguida del nombre de la función y después los parámetros de entrada entre paréntesis seguidos de dos puntos. Una función termina con «return».:
def average(x):
if ~isvector(x)
raise VocationError("Input must be a vector")
return sum(x)/length(x)
Sentencias - las sentencias for y if no requieren la palabra clave «end» en Python. El encabezado del bucle en Matlab varía del de Python. Consulta los ejemplos a continuación:
Código de Matlab:
s = 10;
H = zeros(s);
for c = 1:s
for r = 1:s
H(r,c) = 1/(r+c-1);
end
end
Impresión - Usa «print()» en Python en lugar de «disp» en Matlab.
Documentos útiles
Unidades
La ingeniería requiere cálculos con unidades. Antes de los lenguajes informáticos modernos, los ingenieros usaban papel y lápiz, reglas de cálculo, calculadoras y, más recientemente, hojas de cálculo para hacer cálculos. Todos estos métodos son propensos a errores de cálculo porque las unidades no se manejan como una parte esencial de cada valor. Las hojas de cálculo son especialmente conocidas por sus errores de cálculo porque las conversiones de unidades quedan enterradas en fórmulas que están ocultas en las celdas.
Las operaciones sobre valores con unidades siguen reglas algebraicas muy claras y, por tanto, las unidades pueden asociarse a valores numéricos y llevarse a cabo mediante operaciones matemáticas. Esta capacidad está implementada en Python usando Pint . El paquete Pint incluye una serie de unidades y prefijos (como \(\mu\) para \(10^{-6}\)). ¡Mientras domines el uso de Python y Pint, te despedirás para siempre de las conversiones de unidades sin sentido!
Environmental engineers historically described surface loading rates for clarifiers using units of gal/min per square foot. How fast is \(\frac{1 gpm}{ft^2}\) in \(\frac{mm}{s}\)?
V_surface_loading_rate = (1 * u.gal/(u.min * u.ft**2)).to(u.mm/u.s)
print('The surface loading rate is', V_surface_loading_rate)
print('The surface loading rate is', ac.round_sig_figs(V_surface_loading_rate,2))
La tasa de carga superficial es de 0,6791 milímetros por segundo
Tras reducir el número de dígitos significativos a 2, obtenemos: La tasa de carga superficial es de 0,68 milímetros/segundo
¿Cuánto tiempo tarda en parar un coche que inicialmente circula a 60 mph si el coeficiente de fricción es 0,5?
v_0 = 60 * u.mile/u.hr
friction_coefficient = 0.5
deceleration = friction_coefficient * u.standard_gravity
t_deceleration = v_0/deceleration
print('The time to stop the car is',t_deceleration)
print('The time to stop the car is',t_deceleration.to_base_units())
El tiempo para parar el coche es de 120 millas / hora / standard_gravity
Añadimos la directiva .to_base_units() para forzar la pinta y así simplificar las unidades.
El tiempo para parar el coche es de 5,47 segundos
Muchas funciones escritas en Python aún no manejan unidades, por lo que a veces es necesario eliminar las unidades. Ejemplos incluyen grafos (aunque las unidades podrían estar llegando a matplotlib), funciones SciPy y las funciones NumPy usadas para llenar arrays. En estos casos puedes eliminar las unidades de un número usando el método .magnitud. Ten cuidado de saber cuáles son las unidades antes de eliminarlas, ¡si no, podrías confundirte con los resultados!
Q = 5 * u.gal/u.min
fill_time = 3*u.hr
Volume = Q * fill_time
print('The volume is',Volume)
print('The magnitude of the Volume is', Volume.magnitude)
print('The units of the flow are', Volume.units)
#force pint to display in a selected set of Units
print('The volume is',Volume.to(u.kL))
El volumen es de 15 galones * hora/minuto
La magnitud del Volumen es 15,0
Las unidades del caudal son galón * hora/minuto
El volumen es de 3,41 kilolitros
Es útil forzar la pinta para mostrar el resultado en las unidades que prefieras.
Matrices y unidades
Usa arrays NumPy en lugar de listas Python para habilitar matemáticas con números y unidades. Al crear arrays con unidades, recuerda eso
¡Los elementos del array no tienen unidades!
Los arreglos pueden tener unidades.
Por lo tanto, siempre se adjuntan unidades al array una vez que se ha creado el array. Esto significa que los elementos del array deben ser adimensionales y, por tanto, los arrays deben crearse usando valores adimensionales.
Podemos usar el linspace NumPy con un cambio simple para hacerlo adimensional. Normalmente el linespace tiene elementos de inicio y fin que lógicamente tendrían unidades: np.linspace(inicio, fin, num). ¡Pero los elementos no pueden tener unidades! Podemos hacer que las entradas del linespace sean adimensionales para crear un array adimensional y luego multiplicarlo por el valor final que incluye las unidades para escalar correctamente el array. Para arrays espaciados uniformemente que comienzan al final del primer espacio tenemos o:
np.linspace(inicio/parada, 1, num) * parar
np.linspace(1 / num, 1, num) * stop
Para arreglos espaciados uniformemente que empiezan por cero tenemos:
np.linspace(0, 1, num+1) * ¡Para!
La función de impresión actualmente no puede manejar arrays con unidades. El array puede imprimirse bien en dos pasos, como se muestra a continuación.
n_rows = 10
Flow = 20 * u.L/u.s
Flow_array = (np.linspace(1 / n_rows, 1,n_rows) * Flow)
print('The array of flow rates is',Flow_array.magnitude,Flow_array.units)
Flow_array = (np.linspace(1 / n_rows, 1,n_rows) * Flow).to(u.L/u.s)
print('The array of flow rates is',Flow_array.magnitude,Flow_array.units)
Flow_array = (np.linspace(0, 1,n_rows+1) * Flow).to(u.L/u.s)
print('The array of flow rates is',Flow_array.magnitude,Flow_array.units)
[ 2. 4. 6. 8. 10. 12. 14. 16. 18. 20.] litro / segundo
Trama
Usaremos este estilo de codificación pyplot .
fig es una instancia de Figura—como un lienzo en blanco
ax es una instancia de subtrama de Axes—piensa en un marco para trazar en
Crea un gráfico mostrando caudal frente a profundidad para dos medidores de orificio de flujo lineal que tienen un rango de profundidad de 20 cm y rangos de caudal de 50 y 70 L/s.
“b”, “g”, “r”, “c”, “m”, “y”, “k”, “w”
azul, verde, rojo, cian, magenta, amarillo, negro, blanco
Marcadores de datos (si estás representando datos y no un modelo o ajuste de curva)
H_max = 20 * u.cm
Q_max1 = 50 * u.L/u.s
Q_max2 = 70 * u.L/u.s
num = 50
a = np.linspace(0, 1, num)
x = a * H_max
y = np.empty( (2,num) )
y1 = a * Q_max1
y2 = a * Q_max2
fig, ax = plt.subplots()
ax.plot(x, y1, 'r-', linewidth=2, label=Q_max1, alpha=0.6)
ax.plot(x, y2, 'b-', linewidth=2, label=Q_max2, alpha=0.6)
ax.set(xlabel='water depth ('+str(x.units) +')')
#ax.set(ylabel='Flow rate ('+str(Q_max1.units)+')')
#Below is the method for using latex to format the units
ax.set(ylabel='Flow rate ' + r'$\left (\frac{L}{s}\right )$')
# options: linear or log
ax.set(yscale='log')
ax.set(xscale='linear')
ax.grid(True)
#options:
ax.legend(loc='best')
#alternative method to create a legend instead of using "label=Q_max1 in ax.plot"
#ax.legend([Q_max1,Q_max2])
fig.savefig('../Images/LFOM_flow_vs_height')
plt.show()
Figura 266 El flujo a través de un LFOM es directamente proporcional a la altura del agua sobre el fondo de la primera fila de orificios.
La indexación se hace por fila y luego por columna. Para llamar a todos los elementos de una fila o columna, usa dos puntos. Como puedes ver en el siguiente ejemplo, la indexación en Python comienza en cero. Así que a[:,1] llama a todas las filas de la segunda columna
#create an empty array
a = np.empty((2,5))
np.shape(a)
np.size(a)
#Given that I'm going to using np.array to assign the elements I didn't need to create the empty array first.
a = np.array([[1,2,3,4,5], [2,4,6,8,10]])
a[1,3]
a[0]
a[1]
a[:,2]
#access the last row by find the shape, selecting the 2nd element in the shape, and then subtracting one
a[:,np.shape(a)[1]-1]
'''specify a range of values in an array. Use a colon to slice the array, with the number before the colon being the index of the first element, and the number after the colon being **one greater** than the index of the last element'''
a[0,2:5]
Problema de ejemplo
Calcular el número de moles de metano en un recipiente de 20 L a 15 psi por encima de la presión atmosférica con una temperatura de 30 °C.
# First assign the values given in the problem to variables.
P = 15 * u.psi + 1 * u.atm
T = 30 * u.degC
V = 20 * u.L
# Use the equation PV=nRT and solve for n, the number of moles.
# The universal gas constant is available in pint.
nmolesmethane = (P*V/(u.R*T.to(u.kelvin))).to_base_units()
print(nmolesmethane)
print('There are ', nmolesmethane ,' of methane in the container.')
Hay 1,625 moles de metano en el recipiente.
Funciones
Cuando sea necesario realizar el mismo cálculo varias veces, es útil crear una función que facilite el cálculo en el futuro.
Los bloques de función comienzan con la palabra clave def seguida del nombre de la función y los paréntesis ( ).
Cualquier parámetro de entrada o argumento debe colocarse dentro de estos paréntesis.
El bloque de código dentro de cada función comienza con dos puntos (:) y está indentado.
La sentencia return [expresión] sale de una función y devuelve una expresión al usuario. Una sentencia return sin argumentos es lo mismo que return None.
(Opcional) La primera instrucción de una función puede ser la cadena de documentación de la función o docstring, escrita con apóstrofes .
A continuación se muestra un ejemplo de una función que toma tres entradas: presión, volumen y temperatura, y devuelve el número de moles.
# Creating a function is easy in Python
def nmoles(P,V,T):
return (P*V/(u.R*T.to(u.kelvin))).to_base_units()
Prueba a usar la nueva función para resolver el mismo problema que antes. Puedes reutilizar las variables. Puedes usar la nueva llamada a la función dentro de la instrucción print.
print('There are', nmoles(P,V,T),'of methane in the container.')
There are 1.62 mol of methane in the container.
Base de datos de tuberías
Las tuberías https://github.com/AguaClara/aguaclara/blob/master/aguaclara/core/pipes.py tienen muchas funciones útiles relacionadas con el tamaño de las tuberías. Proporcionan funciones que calculan los diámetros internos y exteriores reales de la tubería dado el diámetro nominal de la tubería. Ten en cuenta que diámetro nominal simplemente significa el diámetro que se llama (de ahí el descriptor «nominal») y, por tanto, una tubería de 1 pulgada de diámetro nominal podría no tener dimensiones que sean realmente de 1 pulgada.
import aguaclara.core.pipes as pipe
# The OD function in pipedatabase returns the outer diameter of a pipe given the nominal diameter, ND.
pipe.OD(6*u.inch)
6,625 pulgadas
La función ND_SDR_available devuelve el diámetro nominal de una tubería que tiene un diámetro interior igual o mayor que el diámetro interior solicitado SDR, relación de diámetro estándar . A continuación encontramos la tubería más pequeña disponible que tiene un diámetro interior de al menos 7 cm
IDmin = 7 * u.cm
SDR = 26
ND_my_pipe = ac.ND_SDR_available(IDmin,SDR)
ND_my_pipe
3,0 pulgadas
El diámetro interior real de esta tubería es
ID_my_pipe = ac.ID_SDR(ND_my_pipe,SDR)
print(ID_my_pipe.to(u.cm))
8.2 cm
Podemos mostrar los tamaños nominales de tuberías disponibles que están en nuestra base de datos.
ac.ND_all_available()