Catálogos publicados

Una biblioteca que calcula con una densidad tiene que sacarla de algún sitio. Esta la saca de una página, y se queda con la página: cada fila de abajo nombra el libro, la tabla, la página del PDF y el folio impreso en los que se leyó, y dice lo que decía su celda de verdad. Una densidad impresa como intervalo aquí es un intervalo, un factor de pérdidas impreso como cota superior es una cota, y una tortuosidad que una página imprime como la palabra model es esa palabra, porque ahí la magnitud depende de la frecuencia y ningún número suelto la representa.

De esa disciplina se siguen tres cosas, y las tres se ven en las tablas.

Los libros discrepan, y la clave dice cuál habla. Cuatro de ellos imprimen un acero a 7 800 kg/m³ y no hay dos que coincidan en su módulo. Eso no es un defecto que haya que promediar: es la dispersión de la literatura, y un catálogo que eligiera uno la estaría escondiendo. Las filas llevan por clave la tabla de la que salieron, y las búsquedas de la biblioteca devuelven la lectura de cada libro en vez de elegir entre ellas.

Un número que ha calculado esta biblioteca va marcado. Una página que imprime un módulo y una densidad ha impreso una velocidad de barra sin escribirla, así que la fila la lleva; pero se muestra en cursiva, y de qué se calculó está a un puntero de distancia. Ningún valor derivado se guarda como si se hubiera leído. Otras dos clases de celda guardan el número de la propia página y dicen cómo llegó ahí: un valor que la página da en una unidad que esta biblioteca no guarda, grados Fahrenheit, psi o sabines, está convertido, y la marca da la cifra de la página y su unidad; y una celda que la página deja en blanco porque imprime el valor una sola vez para un bloque de filas está arrastrada, y la marca nombra la fila que lo imprime. Un valor que la propia fuente llama estimación va marcado como tal.

Un material marcado con un asterisco lleva una nota que hizo su página sobre él, y la nota se lee sobre el nombre. Igual que el motivo de cualquier celda que no sea un número a secas.

Nada de esto es una especificación. La densidad de un bloque varía con el fabricante, la de una espuma con el lote, y los libros lo dicen imprimiendo rangos donde un rango es lo que se sabe. Usa una fila para reproducir un ejemplo resuelto, para contrastar una medida o para tener un orden de magnitud; para lo que tenga que estar bien, mide la probeta.

Cada catálogo es un diccionario de '<tabla>/<fila>' a una fila, y la fila devuelve lo que su página imprimió. Una magnitud que la página dio es un atributo; una que no dio responde None, y la fila dice por qué.

from phonometry import materials

foam = materials.PUBLISHED_POROUS["allard-2009-table-13-1/foam"]
print(foam.source)
print(foam.printed("flow_resistivity_pa_s_m2"), "Pa s/m2")

screen = materials.PUBLISHED_POROUS["allard-2009-table-11-5/screen_2"]
print(screen.tortuosity)
print(screen.why_missing("tortuosity"))

printed es la lectura estricta: devuelve el número que imprimió la página o se niega, nombrando la página y lo que había en la celda. Úsalo allí donde un número equivocado sea peor que una excepción.

Preguntar por un nombre da todos los libros a la vez, que es la comparación que ningún libro por separado puede hacer. El nombre que se pregunta es el que imprime el libro, casi siempre en inglés: las tablas de esta página muestran los nombres, las notas y las fuentes en español, pero su buscador encuentra cada fila también por el nombre del libro, que es el que hay que escribir aquí.

for row in materials.porous_materials_named("Mineral wool"):
    interval = row.ranges.get("porosity")
    print(row.table, row.porosity if interval is None else interval)

El catálogo de suelos funciona igual, y alimenta a los modelos que piden una resistividad al flujo:

from phonometry import environment

pasture = environment.PUBLISHED_GROUND["bies-2017-table-5-2/normal_uncompacted_ground"]
print(pasture.harmonoise_class, pasture.printed("flow_resistivity_pa_s_m2"))

over_pasture = environment.ground_effect(
    [125.0, 250.0, 500.0, 1000.0],
    1.0,
    1.5,
    50.0,
    flow_resistivity=pasture.printed("flow_resistivity_pa_s_m2"),
)
print(over_pasture.excess_attenuation.round(2), "dB")

Un estado de fluido es un Fluid como cualquier otro, así que entra en las mismas llamadas; lo que lo distingue es que su model nombra una tabla y no una forma cerrada.

from phonometry import fluids

sea = fluids.PUBLISHED_FLUIDS["bies-2017-table-c1-fluids/sea_water"]
print(sea.model)
print(sea.validity)

Constantes elásticas, velocidades de onda y factores de pérdidas, leídos de nueve tablas de ocho libros. Siete de esos libros imprimen un acero y no son el mismo acero, y por eso la clave nombra la tabla de la que salió. Tres polímeros los imprime un libro en su forma expandida y otro en la maciza bajo el mismo nombre desnudo, con densidades que difieren entre doce y veinticinco veces; se guardan los dos, y el módulo y la velocidad de cada fila dicen cuál describe.