Rhino Python 1

RHINO USER MEETING DAY
RHINOSCRIPT - PYTHON | DISEO ALGORTMICO
PROFESOR ADOLFO NADAL SERRANO

RHINOSCRIPT - PYTHON
ADOLFO NADAL SERRANO MAS. ARCHITECT - ARCHI [O] LOGICS
TOPOLOGA DE LA GEOMETRA NURBS

[Non-Uniform Rational Bezier Splines]
[ 2 ]
[ 3 ]

I. NOCIONES BSICAS DE PROGRAMACIN

Aproximarse a la topologa NURBS implica un conocimiento amplio de la descripcin geomtrica de los objetos a partir
de frmulas matemticas y, de manera implcita, del comportamiento y descripcin de las mismas en los entresijos del ordenador. Es, por tanto, imprescindible, iniciarse en el apasionante mundo de la programacin, y, si bien no llegaremos a ser
programadores profesionales, s podremos entender y crear geometras complejas a travs de rutinas y scripts, pequeos
programas hechos a medida que nos dan acceso directo al ncleo de Rhino, as como sus funciones y mtodos.

1. Scripts, ejecucin secuencial y programacin orientada a objetos

Generalmente, la manera ms sencilla de comenzar un cdigo es mediante la utilizacin de comandos u rdenes
dadas en una secuencia determinada. Podramos decir que el modo ms primitivo de escribir cdigo es mediante macros,
secuencias de rdenes ordenadas de una manera determinada y que siempre llevan a cabo la misma labor. Las macros no
permiten interaccin con el usuario y son bastante limitadas, si bien son muy tiles a la hora de abordar problemas que requieren mucho esfuerzo o tiempo y que pueden automatizarse (por ejemplo, una secuencia de acciones que abre una imagen, cambia su brillo y su opacidad, la recorta, y la vuelve a guardar). Todos los parmetros implicados en una macro deben
estar predefinidos de antemano, no pudiendo dejar ni una sola variable sin determinar. En el ejemplo anterior, si quisiramos
cambiar el brillo de una imagen, debemos especificar exactamente el nuevo valor de brillo, as como, a la hora de recortarla,
cules son los pxeles que definen el cuadro delimitador del corte.

Un script, en cambio, permite cierta interaccin con el ususario, as como el uso de variables. Esto implica mayor flexibilidad, pero tambin mayor riesgo de error. Los scripts son, en lo que a nosotros nos concierne, el siguiente paso en la inteligencia de la programacin. Dedicaremos a continuacin una buena parte de tiempo a describir y cualificar cmo escribir
scripts y sus diferentes funcionalidades, desde la creacin de geometras complejas hasta la automatizacin de procesos de
creacin de planos para la fabricacin, exportacin de archivos y otras utilidades varias.

Tanto las macros como los scripts, sin embargo, comparten una propiedad fundamental: ambos se basan en una secuencia de rdenes que el ordenador interpreta linealmente. La programacin orientada a objetos permite la descripcin
de objetos [instancias de clases] mediante una serie de caractersticas [propiedades] y comportamientos [mtodos], que
son capaces de interactuar entre s mediante una serie de reglas compartidas definidas a travs de dichos comportamientos.
Dicho paradigma excede el nivel que queremos alcanzar con el presente manual, por lo que lo dejaremos para ediciones
posteriores.

2. Macros

Aunque no es el tema principal que nos ocupa, una leve introduccin a las macros no hace mal, y nos ayudar a entender los conceptos bsicos que hemos descrito anteriormente.

Valga de ejemplo una escalera de caracol: para dibujar una escalera de caracol necesitaramos repetir un objeto (escaln), copiarlo en altura, y rotarlo una serie de grados. Despus, tendramos que tomar el ltimo elemento u objeto creado
(es decir, el escaln que acabamos de copiar) y repetir la operacin una serie de veces hasta que terminemos de rellenar el
espacio necesario.

Hacer esto a mano podra suponernos un buen rato de modelado, aburrido y tedioso. Podemos evitar innecesarias horas delante del monitor si somos capaces de describir [y posteriormente transcribir] las rdenes necesarias en una secuencia
que el ordenador pueda entender. A saber:

1. Selecciona el escaln que quieras repetir

2. Copia dicho escaln

3. Mueve el escaln verticalmente una distancia establecida para la huella, por ejemplo: 15cm.

4. Rota el escaln un cierto ngulo (por ejemplo: 10) alrededor de un eje (por ejemplo uno vertical en 0,0)

Podramos, adems, implementar un ltimo paso que repitiera el proceso una serie de veces, como por ejemplo 15,
pero de momento vamos a dejarlo aqu para facilitar la simplicidad del cdigo. En todo caso, una macro es una lista o secuencia de rdenes predeterminadas que el programa ejecuta.
[ 4 ]

ADOLFO NADAL SERRANO MAS. ARCHITECT - ARCHI[O]LOGICS

Una vez tenemos claro lo que necesitamos hacer, debemos poder transcribir todo en un lenguaje que pueda entender
e interpretar el ordenador. Usaremos el trmino macro para describir un conjunto de rdenes ordinarias de Rhino escritas de
manera secuencial para crear una funcin automatizada. As pues, es scripting en su nivel ms bajo, y veremos que es accesible a cualquier usuario de Rhino, incluso si no tiene conocimientos de programacin. Todo lo que necesitamos, como hemos
dicho, es un conocimiento aceptable de Rhino, algo de experiencia en modelado, y cierto gusto por la experimentacin.

Para escribir una macro precisamos:

- Nuestro propio inters

- Los archivos de ayuda de Rhino, que describen todos los comandos as como sus opciones

- Posiblemente el editor MacroEditor, que permite ejecutar y analizar nuestras macros.
Aqu exponemos algunas de las claves que nos permiten comunicarnos con nuestra herramienta en forma de normas sencillas de sintaxis [puedes ver un listado completo en ings en http://www.rhino3d.com/4/help/information/rhino_scripting.
htm]:

Smbolo Nombre
Explicacin
Guin
Guin Bajo
!
;
\
Signo exclamacin
Punto y coma
Barra invertida
Pause
w
r
<
Pause
Cancela la aparicin de ventanas asociadas a comandos. Todos los comandos pueden, adems, escribirse o llamarse mediante scripts, por lo que es una opcin destacada a la hora de escribir los literales o strings [ya veremos
lo que es sto ms adelante].
Ejecuta el comando en ingls. Necesario para que las macros sean ejecutables independientemente del idioma en
el que estemos usando Rhino actualmente.
Cancela los comandos en ejecucin.
Permite introducir un comentario, que no ser leido por rhino
Si el comando no comienza por ! y termina con la barra invertida \, la macro se ejecutar en la lnea de comandos sin pulsar enter, de manera que se puede introducir ms informacin. Esto es til para construir un comando
a partir de dgitos, decimales, ngulos [tal como <45] y que se encuentran en botones, creando un teclado
numrico en la pantalla.
Para una macro para input de usuario.
Usar coordenadas World Coordinates en vez de coordenadas del plano de trabajo.
Las coordenadas relativas son relativas a la posicin actual del cursor.
Input de ngulo en grados.
Menor que
Y aqu podemos analizar nuestra pequea macro:

Linea
Cdigo
Explicacin
1
2
3
4
5
6
7
8
9
10
11
! _Copy _pause
0,0,0
0,0,1
_enter
Comando copia con espera para intervencin de usuario [seleccin]

Punto inicio [copia]
Punto final [copia]
Finalizar comando
_selLast
Seleccionar ltimo objeto creado
_rotate _pause
0,0,0
10
_enter
Comando rotar con espera para intervencin de usuario

Punto para el eje de rotacin
ngulo de rotacin
Finalizar Comando
[Fig 1. Escalera creada con macro]
[ 5 ]


3. Dnde escribimos las macros?

Perfecto, sabemos escribir un ejemplo de macro, pero, dnde la guardamos? La respuesta es muy sencilla: dado que
una macro equivale, a efectos prcticos, a un comando, no hay mejor manera que asociarla a un botn. Aunque hay diferentes maneras de hacer esto, aqu explicaremos las ms sencilla y directa.

Manteniendo pulsada la tecla Shift mientras ponemos el cursor sobre cualquier botn nos permite Mover o Editar los
botones [figura 2]. Edita el botn y aparecer un men como el de la figura 3.
Menu Emergente
Mover/Editar (Shift+hover)
Copiar/Vincular (Ctrl+hover)
[Fig 2. Men Editar/Mover]
[Fig 3 Men de edicin de botones]

En el espacio reservado para el comando del botn izquierdo del ratn pega el conjunto de rdenes que hemos descrito para nuestra macro. Puedes cambiar la leyenda del mismo. Para guardar los cambios, acepta. Cuando cliques sobre el
icono del botn, se ejecutar la macro. Puedes tambin editar el aspecto del botn, pero eso lo dejaremos para despus,
cuando tratemos la personalizacin de la interfaz.

Puedes probar tus macros en el editor de macros. Dicho editor es, adems, una herramienta til para excribir macros y
detectar posibles errores. Usa el comando ejecutar de la ventana de edicin para probar tu cdigo.

4. Variables y scripts

Una vez nos hemos familiarizado con el comportamiento bsico de las macros, podemos empezar a pensar en sistemas
ms complejos que requieran interaccin usuario-ordenador y la introduccin de variables para dicha interaccin, es decir,
sistemas dinmicos que son capaces de manejar distintas situaciones. El funcionamiento de los scripts es similar, si bien se
requieren conocimientos de lenguajes de programacin [es decir, no vale solamente con copiar y pegar nombres de coman-
[ 6 ]

dos] y de modelado.

Las limitaciones de las macros han dado lugar, por tanto, a los scripts, una suerte de lugar indefinido entre simples
secuencias de rdenes y programas compilados. As pues, las macros pueden realizar operaciones matemticas, evaluar condicionantes, responder al entorno y comunicarse con el ususario. Rhinoceros, en su versin 4, implementa VBScript, lo que
significa que aquello que es vlido para VBScript, lo es tambin para RhinoScript. Rhinoceros v5 implementa adems python,
por lo que habr que ir incorporando lentamente este lenguaje a nuestro da a da.

Traducir RhinoScript en lenguaje natural [con el que nos comunicamos t y yo] no debe ser muy complicado a este
nivel. Inicialmente, los lenguajes de programacin eran un conjunto de ceros y unos, que con el tiempo [el paso de generaciones de lenguajes en su sentido ms estricto] se han conseguido hacer fcilmente entendibles para seres humanos. Las
primeras generaciones de lenguaje cdigo mquina son muy difciles de entender, y no tienen cabida entre la mayora de
nosotros. Afortunadamente, se ha evolucionado en los sucesivos desarrollos generacionales hacia una mayor encapsulacin
que abriese el marco de la programacin a gente no necesariamente iniciada.

Por ejemplo, es posible que queramos guardar unas curvas de nuestro modelo en 3D para modificarlas o borrarlas
posteriormente, o tal vez necesitemos conocer la fecha para saber si el software ha expirado; ninguno de estos datos est
disponible cuando se ha escrito el script y sern slamente accesibles a travs de variables.

Pero volviendo a lo que nos ocupa, sabemos que a menudo necesitamos almacenar informacin para realizar los clculos que nos lleven, poco a poco, a la resolucin de problemas complejos. Dichos clculos forman parte de un todo que
podemos denominar algoritmo: una secuencia de rdenes determinada, que en un tiempo finito, da un resultado concreto
y correcto. El almacenamiento de informacin para su uso en los algoritmos se puede [y debe] llevar a cabo mediante variables, contenedores de informacin que constan bsicamente de:
- Nombre: El nombre es un dato simblico que se refiere a informacin almacenada en memoria. Dicho nombre puede ser cualquiera en rVB, con las siguientes salvedades:

Comenzar por carcter alfabtico

Contendr menos de 255 caracteres

No se permiten espacios en blanco, puntos, ni caracteres especiales (!,, : ; , ...)

No pueden emplearse palabras reservadas del lenguaje
- Tipo: indica el tipo de informacin que almacena una variable. Por ejemplo, y sin entrar en mas detalles, las
variables Single y Double pueden ocupar nmeros reales muy grandes. Adems, hay otro tipo de variables, las denominadas
variant, que son como una variable estndar que admite cualquier tipo de dato.
- Alcance [tiempo de vida]:

Global: para variables declaradas fuera de funciones y subrutinas y accesibles desde cualquier parte
del cdigo.

Local: variables declaradas dentro de funciones y subrutinas, no se podr tener acceso a ellas desde
otra parte del cdigo. Esto es, si declaro una variable dentro de una funcin, solamente podr acceder a ella
mientras me encuentre en la funcin. Si quiero, posteriormente, usar el valor de la misma, deber pasarla
como referencia bien como valor.
algunNumero = RhinoScriptSyntax.GetInteger(Introduce un nmero,0,50,100)
En este ejemplo, algunNumero es sencillamente un placeholder para un valor determinado, que obtendremos cuando se ejecute el script [en tiempo de ejecucin]. Est claro que, cuando estamos escribiendo el script
no conocemos el valor de la variable.
Fjate adems que el nombre de la variable algunNumero no tiene tilde, ya que sera considerado un carcter
especial, cuyo uso est prohibido para la nomenglatura en cdigo [visita de nuevo las caractersticas de los
nombres si tienes alguna duda]. Recuerda que el lenguaje de cdigo por excelencia es el ingls.
[ 7 ]


El uso de las variables debe incluir tres pasos:

- Declarar y comentar la variable [esto puede hacerse o no, en funcin del alcance de la misma].

- Inicializar la variable [asignar un valor inicial]

- Programar las debidas instrucciones.
Tipo Tamao Rango
Boolean 1 Bit True/False

Byte
Entero Corto: 1 Byte
De -128 a 127
Integer Entero: 2 Bytes De -32768 a 32767
Long Entero: 4 Bytes De -232/2 a (232/2-1)
Single Real Simple Precisin: 4 bytes Real
Double Real Doble Precisin Real
Carcter 1 Byte De -128 a 127
String Cadena de caracteres Texto
Date Fecha Fecha

Es posible que en ocasiones [y de hecho, la mayora de las veces sucede] deseemos agrupar variables, tales como
Nombre, Empresa, Cargo, Sueldo, o cualquier otro. Python, al contrario que vbScript, nos dota de un sistema potente y
bastante til para lidiar con este asunto. Tanto los tuples como las listas son estructuras de informacin capaces de agrupar
variables; puedes pensar en ellas como contenedores de informacin, una especie de bandeja donde podemos colocar los
platos de una buena comida.
[Fig 4. Ejemplos cotidianos de arrays: una granja solar, un contenedor]

5. Declaracin e inicializacin de variables en rVB y Python

De igual manera que tu interlocutor te preguntar quin es Pepe a tu afirmacin ayer fui al cine con Pepe, si no le
conoce, RhinoScript solicita saber con quin est tratando, es decir, requiere saber qu variables vas a utilizar durante la
ejecucin del script. Si bien esto es cierto para scripts escritos con VB, python es ms directo y admite la declaracin e inicicalizacin simultnea de variables. Generalmente es necesario y suficiente presentar [declarar] una variable antes de usarla,
es decir, valdra con afirmar Pepe es un amigo.

En rVB se declaran las variables utilizando la palabra reservada Dim, de la siguiente manera:

Dim nombreVar
Dim algunNumero

Esto es todo lo que necesitamos hacer para hacer saber a Rhino que vamos a utilizar una variable cuyo nombre es algunNumero.

Para arrays, esto funciona exactamente igual, ya que se comportan como una variable:

Dim nombreArr
Dim conjuntoNumeros

En python, sin embargo, podemos declarar las variables al mismo tiempo que las usamos, segn asignamos valores
(es decir segn inicializamos las variables). Python, adems, distingue entre listas, tuples, y variables. Tanto las listas como los
tuples son conjuntos de variables; las listas, para mayor complejidad, son dinmicas [lo que significa que se pueden aadir
elementos a la lista, modificarlos, o eliminarlos].

[ 8 ]


De este modo, el equivalente a lo visto anteriormente en Python sera:

nombreVar = valorVar

algunNumero = 25

Queda patente que la declaracin e inicializacin de la variable se hacen de manera simultnea. Asimismo, veremos
que se puede comenzar por el valor None, una especie de Ninguno, una manera de decir que la variable no tiene contenido.
De este modo podemos declarar una variable sin valor, y asignarle un valor posteriormente. Adems, este no valor None es
el que devuelven las funciones de RhinoScript cuando fallan. Es la manera que tiene Rhino de decirnos no lo s.

algunNumero = None
...

algunNumero = 25

La asignacin del valor se hace mediante el smbolo =, que asigna el valor de la derecha al elemento que se encuentre
a su izquierda. As pues a=1, asigna el valor 1 a la variable de nombre a. El tipo de valor que asignemos a la variable determinar el tipo de la variable, de manera que si asignamos un nmero la variable tendr carcter numrico, y si asignamos, por
ejemplo, una cadena de caracteres, tendr tipo String.

El nombre de la variable hace que podamos entender lo que sta contiene. Podramos asignar algunNumero = Presidente, y RhinoScript lo entendera perfectamente. Sin embargo, nos llevara a error con absoluta seguridad.

Esta asignacin se vuelve ligeramente ms compleja cuando tratamos con listas. Las listas, como hemos dicho anteriormente, son conjuntos de elementos, por lo que habr que asignar un conjunto como valor inicial:

conjuntoNumeros = [ ] #esto indica que el conjunto est vaco

conjuntoNumeros = [val1,val2,val3,val4,val5]

Una vez ms, el nombre es independiente de los valores que contiene la variable [esto es, es para uso humano solamente], por lo que es ms que recomendable tener un nombre descriptivo, sencillo de recordar, y corto, para evitar errores
de tipografa.

6. Asignacin de valores

Al igual que para inicializar variables, la asignacin de valores hace uso del smbolo =, y funciona de la misma manera.
Durante la ejecucin del script podemos cambiar el tipo de valor que almacena la variable, pero esto no es recomendable por
coherencia y claridad. adems, los seres humanos tenemos muy mala memoria, est casi garanztizado que no seremos capaces de recordar la razn por la que hicimos esto o lo otro dos das despus de haberlo hecho, as que es una buena prctica
mantener una coherencia en todo el cdigo.

7. Obtencin/acceso de valores; cambio de los mismos.

Necesariamente, si almacenamos informacin, necesitaremos acceder a ella, tal vez nicamente para conocer su estado, tal vez para modificarla o hacer algn tipo de tarea. La manera de acceder a la inormacin es tan sencilla como escribir lo
siguiente:

queNumero = algunNumero
O, por ejemplo, imprimir su valor en la pantalla (lnea de comandos)
print algunNumero

En el primer caso hemos asignado el valor de la variable algunNumero a la variable queNumero. En el segundo caso,
hemos dicho a Rhino que imprima en la lnea comandos el valor de algunNumero. Evidentemente, podemos tambin modificar el valor de la variable o usarlo en alguna operacin matemtica.
[ 9 ]

otroNumero = math.sin(algunNumero)
otroNumero = otroNumero + 10

De nuevo, hemos usado la funcin sin [seno] para calcular el valor del seno de algunNumero, y asignar dicho valor a la
variable otroNumero. Despus, hemos modificado el valor de otroNumero incrementandolo en 10. Recomiendo que pruebes
este conjunto de operaciones en un sencillo script, que se podra transcribir como sigue:
import rhinoscriptsyntax as rss
def simpleOperation():
algunNumero = None
otroNumero = None
algunNumero = 90
otroNumero = math.sin(algunNumero)
print algunNumero
print otroNumero
otroNumero = otroNumero +10
print otroNumero
return
call simpleOperation()

8. Estructura del cdigo

Acabas de ver [y escribir!] posiblemente tu primer script, enhorabuna! Vers que la estructura del cdigo es muy simple, y consta esencialmente, de las siguientes partes reconocibles a simple vista:

importacin de rhinoscriptsyntax

declaracin de variables globales [ya lo veremos en un futuro...]

declaracin de funciones mediante la palabra reservada def

bloques de cdigo de funcin [indentado]

llamadas a dichas funciones con la palabra call

Puede parecer que la estructura es algo compleja, sin embargo, cuando comencemos a escribir, veremos que es mucho
ms sencilla de lo que aparenta. En este caso, ms es menos.

La importacin, por ejemplo, nos permite acceder a funciones nativas de Rhinoscript de manera sencilla. Estas funciones son preexistentes y se denominan mtodos.

9. Funciones y subrutinas

Todo lo que debes saber de funciones y subrutinas es que son bloques de cdigo con un nombre asignado [de manera
que puedas llamarlas o usarlas cuando lo necesites], una serie de argumentos [datos que necesitan para ejecutar correctamente] y un resultado, que puedes decidir pasar o no.Ya ahondaremos en este tema al tiempo que comencemos a escribir
scripts ms complejos.
Recuerda:

- Las subrutinas son bloques de cdigo que expresan la secuencia de ejecucin del programa. Deben ser llamadas
desde fuera y tienen la capacidad de llamar asimismo a otras subrutinas y funciones.

- Las funciones bloques de cdigo, grupos de rdenes en secuencia que se agrupan por su lgica. Cada funcin debe
tener una nica finalidad. Las funciones, si estn debidamente escritas, podrn reutilizarse para varios cdigos.

- Mtodos: los mtodos son funciones ya escritas que pertenecen a libreras preexistentes. En el caso de Rhinoceros, se
accede a ellos mediante el prefijo rhinoscriptsyntax., lo que indica que la funcin est en un paquete con ese nombre.
[ 10 ]


10. Ejemplo de cdigo:

Puedes comenzar a escribir el siguiente script en el editor de scripts de Rhino, que puedes ejecutar mediante el comando _EditScript. Por defecto, a partir de la versin 5.0 de Rhino, el editor de Scripts ser Monkey.

El script crea una serie de puntos en el modelo tridimensional de Rhino que tengas abierto. Vers que, una vez terminado el script, estos objetos son una parte ms del mismo, y que podrs transformarlos, editarlos, o borrarlos a tu antojo.
Procura copiar el script exactamente como se escribe; de otro modo podras tener problemas de sintaxis con los que es ms
que probable que no ests familiarizado, por lo que podras bloquearte. Recuerda, es mala idea generalmente tratar de resolver problemas relacionados con estos asuntos durante ms de 30-60 minutos sin consultar la ayuda de una persona ms
experta. Se trata de aprender, no de desesperar.

Vers que al copiar el cdigo en tu editor de scripts, algunas palabras cambian de color, son palabras reservadas de
python. Aquellas lneas precedidas de # [almohadilla] son comentarios, y no sern leidas por Rhino. Son para uso humano.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
#example 1: create a series of points/spheres

def createPoints():
print This definition (function) creates points using 3 loops
maxX = 10
maxY = 10
maxZ = 10
for i in range (maxX):
for j in range (maxY):
for k in range (maxZ):
ptarr = [i,k,j]
pt = rss.AddPoint(ptarr)
sp = rss.AddSphere(pt,0.25)
rss.ObjectColor(pt,(i*255/maxX,j*255/maxY,k*255/maxZ))
rss.ObjectColor(sp,(i*255/maxX,j*255/maxY,k*255/maxZ))
createPoints()
Fjate en la descripcin del script lnea por lnea para entender exactamente qu ocurre.
1
3
5
6-20
6
8-10
12
13
14
15
16
17
18-19
21
[ 11 ]
Comentario para el ususario o lector del script que comenta lo que ste hace
Importacin de Rhinoscriptsyntax para poder acceder a los mtodos nativos del mismo
Comienzo de la funcin createPoints, o signatura de la misma mediante la palabra reservada def, nombre, y argumentos o
parmetros (parntesis), seguido de dos puntos (:) para indicar que viene a continuacin..
Cuerpo de la funcin. Observa que est indentado
Llamada a la funcin de python print, que imprime un mensaje en la ventana de comando. El mensaje se escribe entre comillas
para indicar a python que se trata de una cadena de caracteres.
Declaracin e inicializacin de las variables maxX, maxY, y maxZ, todas con el mismo valor.
Iniciacin de un bucle o loop que se ejecutar 10 veces (0,1,2,3,4,5,6,7,8,9)
Iniciacin de un bucle o loop que se ejecutar 10 veces (0,1,2,3,4,5,6,7,8,9) para cada una de las 10 anteriores.
Iniciacin de un bucle o loop que se ejecutar 10 veces (0,1,2,3,4,5,6,7,8,9) para cada una de las 100 anteriores. En total, el bloque de cdigo que se encuentra entre las lneas 15 y 20 se ejecutar 10*10*10 = 1000 veces (en slo 3 lneas!).
Declaracin e inicializacin de una lista con 3 valores (un punto!!)
Aadimos el punto al modelo. Observa que el mtodo AddPoint (que ya est definido por Rhino) viene precedido de rss., el
nombre que hemos puesto a nuestra importacin de rhinoscriptsyntax. Asimismo, para que python pueda aadir el punto al
modelo deberemos darle la informacin de x, y, z (es decir, las coordenadas en el espacio). Nosotros guardamos estas coordenadas en la variable (lista) ptarr que hemos definido previamente en la lnea 15.
Aadir una esfera al modelo de manera anloga. Se necesita un centro (punto tridimensional) y un radio.
Cambiar el color de los objetos
Llamada a la ejecucin de la funcin

[Fig 5 Resultado del script]
[ 12 ]

[ 13 ]

II. PROGRAMACIN Y TOPOLOGA

1. Editor de rhinopython

El editor, adems de espacio para el texto del scrit, incluye el compilador y debugger, una herramienta que permite
localizar y corregir errores en el cdigo. En realidad, todo lo necesario para escribir scripts es un editor de texto (notePad,
wordPad, o cualquier otro). Este texto es despus interpretado, compilado y ejecutado por los intrpretes, compilador y
motor correspondientes.

Rhinoceros incorpora su propio editor de texto, accesible mediante el comando _editscript. Para editar un script de
python, usa el comando _EditPythonScript. El debugger es un programa que ayuda a encontrar errores en el script, especialmente de sintaxis, por lo que te ser sencillo corregir tus scripts durante su ejecucin, mediante la visualizacin de variables
en tiempo real y la deteccin de errores de sintaxis. El highlighter, o reconocimiento automtico de palabras reservadas,
permite que stas aparezcan automticamente en colores que identificarn varios tipos: generalmente azul para palabras
de Python, verde para los comentarios, rojo para cadenas de caracteres, y negro para el resto en general.
1.1. Opciones principales del editor

Las principales operaciones que se pueden realizar son:

- Editar scripts: en la ventana de edicin, donde debes copiar los scripts que hemos escrito anteriormente.

- Consultar la librera, en la ventana de mtodos nativos de Rhinoceros.

- Consultar la ayuda, haciendo doble click sobre el mtodo que se quiere consultar. La ayuda es muy sencilla y explicativa, e incluye lo siguiente:

Nombre del comando, con una breve descripcin de su funcionamiento

Sintaxis y uso: atributos [input] y valores de retorno [output]

Ejemplo, que puedes copiar y pegar directamente en la ventana del editor de scripts.
Ttulo de script
Men
Pestaas de
edicin
Librera general
y rhino
Canvas de edicin
de cdigo
Dilogo de creacin
Depurar (debug)
Ejecutar
Printed output
Variable state monitor
Call stack monitor
[Fig 6. Elementos principales de la interfaz del editor]
[ 14 ]


- Para ejecutar un script usa el botn de play; esto ejecutar el script actual [la pestaa activa].

- Debug los scripts consite en encontrar fallos en el script. Como hemos dicho, esto se realiza visualizando los calores
de las variables en lneas seleccionadas y el estado del script en cada momento. De esta manera podemos encontrar errores
comunes tales como:

Confusin entre tipos de datos; por ejemplo, una variable debera tener valor numrico y contiene una cadena de caracteres o alfabticos.

Errores en la definicin de variables, y sus nombres.

Errores de sintaxis; por ejemplo, en smbolos, (),=. y otros

Errores en el paso de variables en las funciones.

1.2. Instalando el editor. Interfaz.

No es necesario que instales ningn software o extensin adicional, el editor viene ya de serie con la instalacin de
Rhino v5. Como ves en la figura 6, la interfaz es muy clara. Es probable que nicamente necesites usar los botones principales,
que dan acceso a las funciones de edicin, correccin y ejecucin de scripts. Para abrir Monkey, ve a la pestaa que aparece
en la barra de menn, Monkey, y haz click sobre Monkey Editor.

2. Vectores y puntos: una sencilla base de geometras complejas

2.1. Puntos

En Rhinoceros, los puntos son las entidades geomtricas ms sencillas que hay. Tienen tres componentes, que corresponden a su localizacin x,y,z respecto del plano de trabajo universal. Un punto se describe, por tanto de la siguiente manera:
[ 15 ]
[Fig 8 Punto en espacio cartesiano R3: A(a1,a2,a3)]
[Fig 9. Vector v en espacio cartesiano R3: v(v1, v2,v3). El punto de apli-
[Fig 10 Punto en espacio cartesiano R3: A(a1,a2,a3)]
[Fig 11. Vector v en espacio cartesiano R3: v(v1, v2,v3). El punto de aplicacin (base) del vector es (0,0,0) por defecto.]

aPoint = [x,y,z]

Si quisiramos definir un punto en 10,3,7, por ejemplo, lo podramos hacer de la siguiente manera creando una lista o
tuple con las coordenadas del mismo:


x = 10
y= 3
z = 7
aPoint = [x,y,z]
rss.AddPoint (aPoint)

2.2. Vectores

Los vectores tambin se describen por conjuntos de coordenadas, listas que contienen [x,y,z]. En este sentido, son
exactamente iguales que los puntos, y tienen el mismo comportamiento. La nica diferencia estriba en que, por defecto,
todos los vectores estn basados en [0,0,0].

Las operaciones ms sencillas con vectores incluyen suma, diferencia, y escalado, que responden a los siguientes mtodos:

- Suma: VectorAdd (vec1,vec2)

- Sustraccin: VectorSubtract (vec1,vec2)

- Escalado: VectorScale (vec1,vec2)

Donde vec1 y vec2 son arrays de 3 componentes, exactamente igual que en el caso de puntos.

3. Curvas

Podemos entender las curvas como entidades controlables a partir de puntos. Las lneas, polilneas y curvas estn basadas en puntos de control, que definen su geometra, continuidad, y tangencias. Los conceptos bsicos que debemos conocer
en curvas son los siguientes:

- Dominio de una curva: es el conjunto de valores reales que resultan que hace que se cumpla la ecuacin de la misma.
En f(x) = axn+bx(n-1)+(...)+g, por ejemplo, el dominio es el conjunto de valores de x que hacen que f(x) tenga un valor real.
Esto mismo aplica a las curvas NURBS, si bien hemos de ser conscientes que las curvas tienen un principio y un final determinado, y que sus ecuaciones, a las que no podemos acceder, son ms complejas. Sin embargo, existe una clara correspondencia entre dichos valores y la curva, que podemos ver en la figura 12. La ecuacin paramtrica de una recta es como sigue:

(x,y) = (x1,y1) + k(v1,v2)

Como recordars de lgebra, puedes hallar culquier punto de la recta con un vector director y un valor de k, el parmetro. Esto aplica exactamente a las curvas NURBs, si bien su topologa es algo ms compleja. Es suficiente con que recuerdes
que a cada valor de k le corresponde un punto en la recta, y por tanto, en el espacio.

- Puntos de control: puntos que definen el polgono de control, a partir del cual se define, en funcin del tipo de continuidad [es decir, el grado], la curva final.

Con RhinoScript es relativamente sencillo obtener este tipo de informacin, de la misma manera que somos capaces
de acceder a los datos de X,Y,Z, de un punto y modificarlo. Las operaciones ms comunes son las siguientes:

Evaluar el dominio de una curva.

Crear puntos sobre curvas con RhinoScript.

Crear curvas a travs de puntos o usando los puntos como puntos de control de la curva.

De todos modos, este tipo de operaciones los veremos a continuacin en el siguiente apartado, Topologa de la Geometra NURBS II, Geometra computacional bsica 2.

En los scripts que siguen vers que cada una de las funciones incluye a la anterior, de modo que puedes activar y desactivar los sucesivos pasos a medida que vas avanzando. Te recomiendo que borres los objetos creados en cada uno antes
de ejecutar el siguiente, para que puedas comparar los resultados sin miedo a esquivocarte.
[ 16 ]

P0
P6
P1
P5
P2
P7
P4
P8
P3
dom(0)+ dom(0)+ dom(0)+ dom(0)+ dom(0)+ dom(0)+ dom(0)+

1*step
2*step
3*step
4*step
5*step
6*step
7*step
dom(0)
valor mnimo dominio
dom(1)
valor mximo dominio
[Fig 12. Concepto de dominio de una curva. Los valores Dom(0) [min] y Dom(1) [max] no son necesariamente 0 y 1 y son asignados por Rhino.
El cdigo est comentado, de manera que puedes entender cada paso una vez lo vayas copiando en el editor de scripts.
III. SCRIPTS RELACIONADOS
En este punto, presentamos dos scripts. El primero incluye funciones de creacin de puntos. El segundo, anlisis de curvas,
dominios y puntos de control. Ambos comienzan por Option Explicit.
1. Puntos

Como vers, la creacin de puntos es muy sencilla, y se realiza mediante el mtodo [funcin nativa] de Rhino Rhino.
AddPoint. Esta funcin requiere de una matriz de componentes (x,y,z), como hemos visto anteriormente. La subrutina Main
tiene una serie de funciones, crecientes en complejidad.

doSinglePoint aade un punto al modelo en las coordenadas dadas. Prueba a cambiarlas y ejecutar el script. Para ejecutar una nica funcin descomntala, y comenta el resto. Haz esto con cada una de las funciones cambiando los valores.
doPointGrid utiliza dos loops [estructuras do...] para crear una malla de puntos, lo que hace por medio de filas y columnas
[crea una columna con j puntos, luego otra... hasta que hace i columnas con j puntos cada una, en total n = j*i puntos].

El siguiente paso es crear una malla tridimensional, para lo cual createPoints (en la pgina11) aade un valor distinto
de cero para la componente Z del punto. La frmula utilizada para crear Z puede cambiar. Prueba a cambiarla para ver los
distintos resultados.

Una vez que hemos manejado puntos en 3D, podemos proceder a crear lneas. Para ello, examina doLine, una funcin
que crea una lnea a partir de dos puntos definidos explcitamente por su punto origen y punto final [cada uno de ellos por
sus coordenadas X,Y,Z agrupadas en una array]. doLines crea lneas a partir de los puntos en una recta, de la misma manera
que crebamos los puntos en la funcin doPointGrid. Fjate en que hay que esperar a tener al menos dos puntos creados para
proceder a una lnea [para tener en cuenta esta condicin usamos el cdigo condicional if [condicin] ... end if.

Intenta crear una malla de lneas, siguiendo el mismo procedimiento que para doLines, pero en ambas direcciones
(esto es, en X y en Y). doSimpleComponentGrid podra aprovechar los mismos puntos para crear una polilnea [la nica diferencia estriba en que tenemos ahora un nico conjunto de puntos]. Recuerda que para cerrar una polilnea debemos hacer
coincidir el primer punto con el ltimo; es decir, para un cuadrado tendremos 5 puntos [ya que el ltimo ser igual que el
primero si queremos cerrar el polgono].
[ 17 ]


doComplexComponentGrid podra crear, adems del permetro, una curva con los mismos puntos. Esta curva estara
contenida dentro del permetro.
#Script written by <Adolfo Nadal [archiologics.com]>
#Script NOT copyrighted
#Script versin martes, 29 de junio de 2010 18:21:34
#A series of VERY SIMPLE functions to demonstrate the VERY BASICS of NURBS geometry
#In later sessions we will explore how to enhance our lofting capabilities
def doSinglePoint():
#This adds a single point in 0,0,0
#We need to enter the 3D coordinates defining the point in an array (collection of objects)
rss.AddPoint(20,20,0)
def doSinglePointWithAnnotation():
rss.AddPoint(20,20,0)
rss.AddTextDot(A point here,[20,20,0])
def doPointGrid():
for i in range (10):
for j in range (10):
rss.AddPoint(i,j,0)
rss.AddTextDot(Pt at: + str(i) + + str(j),[i,j,0])
def doLine():
rss.AddLine([0,0,0],[0,20,0])
def doLines():
maxX = 10
maxY = 10
for i in range(1,maxX):
for j in range(1,maxY):
rss.AddLine([i,j,0],[i-1,j-1,0])
rss.EnableRedraw(False)
#doSinglePoint()
#doSinglePointWithAnnotation()
#doPointGrid()
#doLine()
#doLines()
rss.EnableRedraw(True)
2. Curvas

La funcin ShowDomain muestra el concepto de dominio de una curva. Para ello, crea un punto en la curva y muestra,
mediante un textDot o anotacin, el valor del dominio en ese punto. El script requiere una curva, que deber ser seleccionada por el usuario. Veremos ms sobre curvas en el siguiente apartado.
def showDomain():
crv = rss.GetObject (Get curve to evaluate,4)
dom = rss.CurveDomain(crv)
rss.AddPoint(rss.EvaluateCurve(crv,dom[0]))
rss.AddTextDot(Dom[0] is: + str(dom[0]),rss.EvaluateCurve(crv,dom[0]))
showDomain()
[ 18 ]

[ 19 ]

TOPOLOGA DE LA GEOMETRA NURBS II

[Non-Uniform Rational Bezier Splines]
[ 20 ]
[ 21 ]

I. GEOMETRA COMPUTACIONAL BSICA 2 - RECTAS Y CURVAS NURBS

1. El dominio de curvas en Rhino y Rhinoscript:

La representacin del dominio de curvas en Rhinoceros responde a una serie de caractersticas y conceptos
que debemos conocer si pretendemos crear scripts o rutinas que incluyan trabajo con lneas, polilneas, curvas o curvas mixtas, sea cual sea su creacin. Es importante resaltar asimismo que los conceptos que siguen aplican a todas las
curvas por igual, con independencia de su grado o manera de creacin.

En lgebra, el dominio de una curva se refiere al conjunto de valores de la variable independiente (normalmente x para los cuales existe un valor real de la variable dependiente (normalmente y). Para ms informacin,
vuelve a ver la figura 12 del apartado anterior.

En geometra computacional, sea cual sea la representacin de la curva, el dominio responde a la definicin
interna de la misma en R1 (es decir, en el espacio de la curva). As pues, en Rhino 4 oscila entre 0 y 1, mientras que en
Rhino 5 entre 0 y la longitud de la curva. En cualquier caso, 0 representa el origen de la curva, y 1 (o su longitud) el final
de la misma.

El dominio responde a la curvatura de la curva, por lo que una divisin del dominio en n partes iguales no se
traduce necesariamente en n segmentos de la misma longitud.

Debemos saber, a la hora de usar curvas para superficies, cul es el origen y el final de la curva, porque esto
influir en comandos como loft, por ejemplo. El comando _flip, invierte el sentido de una curva.
CRV DOMAIN (0)
CURVE OBJECT
MAIN PROPERTIES: ID, DOMAIN, DEGREE
- ID: UNIQUE IDENTIFIER ASSIGNED BY RHINO
AT THE TIME OF CREATION
- DOMAIN: INTERNAL DEFINITION OF A CURVE.
IT IS A VALUE BETWEEN 0 & 1, WHERE 0 REPRESENTS
THE START OF THE CURVE AND 1 THE END.
IT DOES NOT REFER TO ITS LENGTH, RATHER TO ITS
CURVATURE
CRV DOMAIN (X)
CRV DOMAIN (0)<CRV DOMAIN (X)<...<CRV DOMAIN (Z)<CRV DOMAIN (1)
CRV DOMAIN (Y)
CRV DOMAIN (Z)
[Fig 1. Dominio de una curva]
CRV DOMAIN (1)

2. Espacio R1 (curva) y espacio R3 (cartesiano):

As pues, parece obvio que podemos referirnos a los puntos de una curva aproximndonos a ellos de dos
maneras distintas: por un lado, mediante su localizacin en el espacio, es decir, por sus coordenadas (X,Y,Z); por otro, por su
posicin en la curva, es decir, por su domino (d). Esto responde claramente a la diferencia entre R3 [espacio cartesiano] y R1
[espacio unidimensional de la curva]:

R1 es el espacio unidimensional de la curva, definido por un nico valor [dominio]

R3 es el espacio tridimensional cartesiano, definido por tres valores [array(x,y,z)]
[ 22 ]


def showDomain():
crv = rss.GetObject (Get curve to evaluate,4)
dom = rss.CurveDomain(crv)
showDomain()

Por lo tanto, recuerda que cualquier punto de una curva puede expresarse de dos modos: (i) en referencia al espacio
cartesiano [su posicin x,y,z en el espacio], y (ii) en referencia a la curva a la que pertenece, mediante su dominio [que tomar
un valor entre 0 y 1 en Rhino v4, o entre 0 y su longitud en Rhino v5].

3. Curvas a partir de puntos

Rhinoceros permite la generacin de una gran variedad de curvas, entre las que se encuentran:

- Por puntos de control

- Interpoladas [a travs de puntos]

- Interpoladas en superficie [la curva estar contenida en ella]

- Por manejadores [define un punto y su tangencia]

- Trazar [bosquejar] curvas: boceto

- Trazar en malla poligonal/superficie

- Cnicas

- Promedios

Todas estas curvas pueden modificarse una vez terminadas. La modificacin se hace generalmente a partir de los puntos de control, bien por adicin y substraccin, bien por su modificacin. Los puntos de control se comportan como objetos
del dibujo, e incluyen una serie de propiedades., que siguen:

- Posicin

- Peso: grado de influencia sobre la curvatura de la curva [a mayor peso, ms cerca estar la curva de pasar por
el punto de control].

Existen otras tcnicas avanzadas de creacin de curvas, tales como:

- Fluir a lo largo de una superficie

- Curvas UVN [aplicadas sobre superficies]
Curva por puntos de control
Curva por interpolacin
Curva por interpolacin en
superficies
Curva por manejadores
Trazar
Trazar sobre malla
Cnicas y parbolas
Hlice y espiral
Curvas promedio
Activar puntos de control
Activar puntos de edicin/
desactivar seleccionados
Ocultar caras posteriores
de polgono de control
Mover UVN, toque ligero UVN
Insertar nodo/
punto de edicin
Extender/Empalmar
/Achaflanar lnea
Simplificar
Insertar/Eliminar puntos
de control
Cambiar modo de arrastre
Editar con manejadores
Aadir nodo
Eliminar nodo
Definir peso de puntos de control
Subcurva
Insertar lnea en curva
Booleana de curvas
Cerrar curvas abiertas

Eliminar subcurva
Extraer subcurva
[Fig 2. Herramientas de creacin y edicin de curvas - II]
[ 23 ]


Dichas tcnica interpolan de una u otra manera la curva original sobre la superficie seleccionada. La primera admite
guardado de historial, por lo que es muy til a la hora de crear curvas sobre superficies complejas, como por ejemplo fachadas estructurales. La edicin de las curvas se realiza, como hemos dicho, a partir de sus puntos de control, fcilmente accesibles tanto explcitamente [modelando] como implcitamente [a partir de RhinoScript].
II. SUPERFICIES Y POLISUPERFICIES EN RHINOCEROS

1. Direcciones en superficies

- Direcciones U y V:

Las superficies son ms o menos rectangulares. Las superficies tienen tres direcciones, U, V y normal. Las
direcciones U, V y normal se pueden visualizar con el comando Dir. Las direcciones U y V son como el tejido de ropa o
de una tela. La direccin U se indica con la flecha roja y la direccin V con la flecha verde. La direccin normal se indica
con flechas blancas. Las direcciones U, V y normal se corresponderan a las direcciones X, Y y Z de la superficie.

Estas direcciones se utilizan para el mapeado de texturas y la insercin de puntos de control.
- Direccin normal:

En las superficies, la normal es una direccin que seala hacia la parte exterior o superior de la superficie, y
es perpendicular a la superficie en el punto de clculo. Para polisuperficies cerradas (cono, cilindro, caja, etc.) o slidos
de una superficie (esfera, toroide), la normal siempre est orientada hacia fuera. Sin embargo, en una superficie o
polisuperficie abierta la direccin de la normal depende de cmo se cre y puede ser arbitraria.

El comando Dir muestra la direccin de la normal de un objeto.
[Fig 3. Direccin en una superficie]
2. Concepto y manejo de dominios de superficies en Rhinoscript

Al igual que en curvas, el dominio en superficies es la representacin geomtrica interna que nos permite
obtener puntos sobre la superficie en R2 (es decir, sobre el espacio binario de la superficie).

Toda superficie tiene dos dominios, uno en la direccin u y otro en la direccin v, de manera que, mediante la combinacin de dos parmetros i (correspondiente a u) y j (correspondiente a v), se puede hallar y calcular
la posicin de un punto en la superficie (que, de nuevo, puede expresarse en trminos de R2 o R3). Coloquialmente
podramos decir que u y v corresponden a las componentes X e Y sobre un plano [en el que sabemos, por ejemplo,
que la componente Z es 0], pero sobre la superficie.

Para una polisuperficie, el dominio se calcula para cada una de las superficies componente, por lo que es muy
conveniente modelar con superficies.

3. R2 y R3 [espacio superficie y espacio cartesiano]

R2 es el espacio bidimensional de la superficie [coordenadas implcitas a la geometra].

R3 es el espacio tridimensional cartesiano, eso ya lo sabamos. de anteriores descripciones.

Como sabemos, cualquier punto de una superficie puede expresarse de dos modos: (i) en referencia al espacio cartesiano (su posicin x,y,z en el espacio en las coordenadas de dibujo y coordenadas globales), y (ii) en referencia
[ 24 ]

a la superficie a la que pertenece, mediante su dominio [mediante dos valores entre DomMin y DomMax, si dichos
valores no se han normalizado para que sean DomMin = 0 y DomMax = 1].

Normalizado: con la opcin S, los intervalos de los parmetros U y V se escalan para que los valores resultantes estn entre cero y uno (en lugar de usar el valor del parmetro real). Esta opcin es til cuando desea saber el porcentaje del espacio de los parmetros del punto designado sin tener que calcularlo segn el dominio de la superficie.
Con la opcin No, se proporcionan los valores de los parmetros U y V no escalados. Vase tambin Dominio.

Nota: Cuando se selecciona una polisuperficie, Rhino calcula el resultado de la superficie componente en la
posicin designada. Si la superficie es recortada, Rhino usar la superficie no recortada.
[Fig 4. Expresin de superficies y puntos sobre superficies. Dominio]

4. Creacin de superficies, puntos y nubes de puntos, curvas

- Los mtodos ms comunes de creacin de superficies son:

Superficies a partir de puntos: rectangulares, por 3 4 puntos, ajustar plano a travs de puntos.

Superficies a partir de curvas: loft, sweep extrusin, patchwork, revolucin, a partir de una red de curvas.

De la misma manera pueden crearse polisuperficies y slidos. Dejaremos la edicin de slidos por el moment,
ya que stos requieren de un conocimiento propio de modelado con caras que no incluimos en este manual. Si eres
un usuario habitual de programas de modelado 3D para animacin [como por ejemplo Autodesk Maya o Autodesk
3DMax] entonces es probable que te interesen, pero los encontrars limitados con respecto a las limitaciones de dichos programas.

- Precauciones usando el comando loft:

Como norma general, las curvas deben tener el mismo nmero de puntos de control

Asimismo, hemos de ser cuidadosos con el sentido de las mismas, as como su alineacin.
[ 25 ]

FILA 1
Superficie por 3 4 puntos
Superficie por curvas de borde
Superficie a partir de curvas planas
Superficie rectangular
Extruir curva
FILA 2
Loft - transicin
Superficie por network de curvas
Superficie parche
Sweep 1/2 railes
FILA 3
Superficie de revolucin
Cubrir objetos con superficie
Mapa de alturas desde imagen
Superficie desde rejilla de puntos
[Fig 5. Principales herramientas relativas a generacin y ectraccin de informacin de superficies]
[ 26 ]

[ 27 ]

DISEO CON PYTHONSCRIPT

[Cubierta de un estadio]
[ 28 ]
[ 29 ]

I. UN EJEMPLO SENCILLO DE APLICACIN DE RHINOSCRIPT

1. Objetivo:

El objetivo del script es practicar los mtodos ms usuales en rhinoscript, tales como la seleccin de objetos
existentes, y el trabajo con puntos. Adems, crearemos superficies automticamente mediante la interaccin directa
con el usuario.

Aplicaremos el script inicialmente a un conjunto de curvas indiferenciado para comprobar y entender su funcionamiento. Posteriormente entenderemos cmo utilizar el mismo sobre una superficie diseada para albergar una
cubierta de un estadio. Para ello, intentaremos seguir una estrategia en complejidad ascendente, comenzando por
los mtodos ms sencillos hasta conseguir tener un script complejo. RhinoPython es perfectamente compatible con
grasshopper, por lo que ser nuestro lenguaje de programacin preferido.
2. Comenzando: los babystepts:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
#example: get a curve, a number of divisions, and divide curve

def getCurves():
print This definition (function) gets curves in series of three
crv = rss.GetObject(Select curve,4)
if not crv: return
divNr = rss.GetInteger(Nr of divisions,4,6,20)
if not divNr: return
divPts = rss.DivideCurve(crv,divNr)
rss.AddPoints(divPts)
getCurves()
12
13
Comentario para el ususario o lector del script que comenta lo que ste hace
Importacin de Rhinoscriptsyntax para poder acceder a los mtodos nativos del mismo
Comienzo de la funcin getCurves, o signatura de la misma mediante la palabra reservada def, nombre, y argumentos o parmetros (parntesis), seguido de dos puntos (:) para indicar que viene a continuacin..
Cuerpo de la funcin. Observa que est indentado
Llamada a la funcin de python print, que imprime un mensaje en la ventana de comando. El mensaje se escribe entre comillas
para indicar a python que se trata de una cadena de caracteres.
Declaracin e inicializacin de la variable crv, que albergar la curva que seleccione el usuario por medio delmtodo nativo
de Rhino GetObject. Para seleccionar curvas, utiliza el filtro de tipo 4. Si tienes dificultades entendiendo lo que esto significa,
puedes usar la ayuda de RhinoScript.
Nos aseguramos que el usuario ha seleccionado una curva, de manera que, si no es as, salimos de la funcin
Solicitud de un nmero de divisiones determinado por parte del usuario
Una vez ms, no aseguramos el xito de la funcin mediante la comprobacin de la correcta introduccin de datos por el
ususario.
Llamada al mtodo nativo de Rhino para dividir la curva
Aadir puntos en cada una de las divisiones
15
1
3
5
6-13
6
8
9
10
11

Como ves, este sencillo script divide una curva del modelo y aade una serie de puntos sobre cada una de
las divisiones. Esta es la base de nuestro pequeo programa, ya que dividiremos las curvas en una serie de segmentos sobre los cuales crearemos las superficies que van a constituir la cubierta. Como puedes entrever, el nmero de
divisiones producir un efecto diferente, tal y como puedes ver en la figura a continuacin. Como es evidente, podras
usar el nmero de divisiones para optiizar el grado de asoleo de un estadio, por ejemplo, o para crear efectos de vistas
concretos, o incluso simular una estructura arquitectnica completa, en funcin de determinados factores de diseo
que puedas decidir.
[ 30 ]

[Fig 1.Ejemplo de cubierta de estadio]

Como puedes imaginar, lo que se puede hacer con una curva se puede hacer con 3 curvas. En este caso, y al
tratarse de un nmero pequeo de inputs por parte del usuario, no deberamos tener demasiado problema en repetir
el proceso tres veces. Sin embargo, para un mayor nmero de inputs, deberamos considerar trabajar con bucles que
nos permitan hacer una nica seleccin. Iremos viendo esto en pasos sucesivos, pero de momento vamos a conformarnos con conseguir que cada paso aumente la complejidad del script.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
1-9
10-15
20-25
27
[ 31 ]
#example 1: get a curve, a number of divisions, and divide curve

#imports
#define functions
def getCurves():
crv = rss.GetObject(Select first curve,4)
if not crv: return
crv1 = rss.GetObject(Select second curve,4)
if not crv1: return
crv2 = rss.GetObject(Select third curve,4)
if not crv2: return
divNr = rss.GetInteger(Nr of divisions or segments,4,4,20)
divPts1 = rss.DivideCurve(crv1,divNr)
rss.AddPoints(divPts1)
#call function = tell rhino to execute the function
getCurves()
Estas lneas deben ser conocidas a estas alturas

Seleccin de 3 curvas y correspondientes comprobaciones
Divisin de cada una de las curvas y aadir puntos.


Para desarrollar el progama, calcularemos el punto medio entre dos dados, y as formaremos una estructura
con forma de diamante, tal como ves en la figura 2. No existe una funcin para hallar el punto medio dados dos puntos por coordenadas, pero nosotros podemos escribir un algoritmo que funcione para nuestros propsitos.
1
2
3
4
5
1
2
3
4
5
#function to calculate mid pt between 2 given points

def MidPt(pt1,pt2):
midPt = None
midPt = [(pt1[0]+pt2[0])/2,(pt1[1]+pt2[1])/2,(pt1[2]+pt2[2])/2]
return midPt
Comentario que describe el uso de la funcin

Declaracin de la funcin con la palabra reservada def, argumentos entre parntesis, y dos puntos. Los argumentos son los
inputs que precisa la funcin, en este caso dos puntos (definidos por sus coordenadas).
Declaracin de la variable midPt, o punto medio. Este punto medio deber contener el resultado de nuestros clculos, es decir,
el punto medio de dos dados.
Clculo del punto medio
Retorno de la funcin: punto medio
[Fig 2. Puntos medios en la curva intermedia]

Como se ve, podemos llamar la funcin desde cualquier otro punto del cdigo. Evidentemente, esto nos permite reusar bloques de cdigo tantas veces como nos sea necesario. Puedes copiar y pegar dichos bloques de cdigo
tantas veces como sea necesario. Puedes incluso crear bibliotecas de cdigo para reusarlas, del mismo modo que funcionan los mtodos nativos de rhino.
3. Crea curvas a partir de los puntos:

Para crear curvas debes disponer primero de un conjunto de puntos, que has de agrupar en listas. Prueba, por
ejemplo, el siguiente cdigo:
1
2
#generate base curves

basecrv1 = rss.AddCurve([divPts[0],midPts[0],divPts2[0],divPts[0]],1)
[ 32 ]


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
28
29-31
29
30
31
34-37
Con estos dos bloques de cdigo, el script queda del siguiente modo:
#imports
#define functions
def getCurves():
if not crv: return
if not crv1: return
if not crv2: return
#loop to generate mid pts
midPts = []
for i in range (len(divPts1)-1):
midPts.append(MidPt(divPts1[i],divPts1[i+1]))
rss.AddPoints (midPts)
basecrv1 = rss.AddCurve([divPts[0],midPts[0],divPts2[0],divPts[0]],1)
basecrv2 = rss.AddCurve([divPts[1],midPts[0],divPts2[1]],divPts[1],1)
basecrv3 = rss.AddCurve([divPts[0],midPts[0],divPts[1]],divPts[0],1)
basecrv4 = rss.AddCurve([divPts2[0],midPts[0],divPts2[1]],divPts2[0],1)
def MidPt(pt1,pt2):
midPt = None
return midPt
getCurves()
Declaracin de la lista que va a contenter a los puntos como una lista vaca. Iremos llenando la lista dentro del bucle
Bucle para generar los puntos medios en la curva intermedia
Esta lnea es fundamental. Decimos a Rhinoscript que, para cada uno de los puntos en los que hemos dividido la curva intermedia, repita la lnea 30. Es decir, para cada punto (desde el 0 hasta el penltimo para ser ms exactos), cogeremos el punto
actual y el siguiente, y llamaremos a la funcin Midt(punto actual, punto siguiente), obteniendo de esta manera el punto
medio correspondiente.
Llamada a la funcin punto medio y guardado de su valor en la variable midPts. Append aade cada uno de los puntos obtenidos a la lista de puntos medios.
Aadir puntos al modelo.
Aadimos las curvas correspondientes como base para las superficies del modelo. En total son 4 curvas.
Finalmente, podemos crear superficies planas a partir de las curvas que hemos creado. Vers que las curvas son de grado 1, por lo que se asemejarn a polilneas. Adems, tienen 4 puntos, pero al coincidir el primero y el ltimo sabemos
que es una curva cerrada, por lo que en realidad se trata de un tringulo. Todo tringulo define un plano.
[ 33 ]

4. Finaliza el script e intenta ampliar su funcionalidad:

El script queda de la siguiente manera. Puedes probar a unir las superficies, cambiarlas de color, borrar alguna
superficie, o cambiar su material, por ejemplo.

Haz eso entre las lineas 45 y 47, una vez hayas creado todas las superficies. Vers que hemos incluido llamadas
a EnableRedraw. Esto acelera el proceso sustancialmente, ya que evita que la pantalla de rhinoceros se actualice con
cada cracin de objetos.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56

#imports
#define functions
def getCurves():
if not crv: return
if not crv1: return
if not crv2: return
#loop to generate mid pts
midPts = []
for i in range (len(divPts1)-1):
midPts.append(MidPt(divPts1[i],divPts1[i+1]))
#rss.AddPoints (midPts)
rss.EnableRedraw (False)
for i in range (divNr):
#baseCrv1 = rss.AddCurve([midPts[i],divPts[i+1],divPts2[i+1],midPts[i]],1)
baseCrv2 = rss.AddCurve([midPts[i],divPts2[i+1],divPts2[i],midPts[i]],1)
baseCrv3 = rss.AddCurve([midPts[i],divPts2[i],divPts[i],midPts[i]],1)
baseCrv4 = rss.AddCurve([midPts[i],divPts[i],divPts[i+1],midPts[i]],1)
#generate surfaces
#srf1 = rss.AddPlanarSrf(baseCrv1)
srf2 = rss.AddPlanarSrf(baseCrv2)
rss.EnableRedraw(True)
def MidPt(pt1,pt2):
midPt = None
return midPt
getCurves()
[ 34 ]

Rhino Python 1

Încărcat de

Informații document

Drepturi de autor

Formate disponibile

Partajați acest document

Partajați sau inserați document

Opțiuni de partajare

Vi se pare util acest document?

Este necorespunzător acest conținut?

Drepturi de autor:

Formate disponibile

Rhino Python 1

Încărcat de

Drepturi de autor:

Formate disponibile

RHINO USER MEETING DAY

RHINOSCRIPT - PYTHON | DISEO ALGORTMICO

PROFESOR ADOLFO NADAL SERRANO

RHINO USER MEETING DAY

ADOLFO NADAL SERRANO MAS. ARCHITECT - ARCHI [O] LOGICS

TOPOLOGA DE LA GEOMETRA NURBS

RHINO USER MEETING DAY

ADOLFO NADAL SERRANO MAS. ARCHITECT - ARCHI [O] LOGICS

I. NOCIONES BSICAS DE PROGRAMACIN

RHINO USER MEETING DAY

ADOLFO NADAL SERRANO MAS. ARCHITECT - ARCHI[O]LOGICS

Y aqu podemos analizar nuestra pequea macro:

Comando copia con espera para intervencin de usuario [seleccin]

Seleccionar ltimo objeto creado

Comando rotar con espera para intervencin de usuario

[Fig 1. Escalera creada con macro]

RHINO USER MEETING DAY

ADOLFO NADAL SERRANO MAS. ARCHITECT - ARCHI [O] LOGICS

[Fig 2. Men Editar/Mover]

[Fig 3 Men de edicin de botones]

RHINO USER MEETING DAY

ADOLFO NADAL SERRANO MAS. ARCHITECT - ARCHI[O]LOGICS

RHINO USER MEETING DAY

ADOLFO NADAL SERRANO MAS. ARCHITECT - ARCHI [O] LOGICS

[Fig 4. Ejemplos cotidianos de arrays: una granja solar, un contenedor]

RHINO USER MEETING DAY

ADOLFO NADAL SERRANO MAS. ARCHITECT - ARCHI[O]LOGICS

conjuntoNumeros = [ ] #esto indica que el conjunto est vaco

O, por ejemplo, imprimir su valor en la pantalla (lnea de comandos)

RHINO USER MEETING DAY

ADOLFO NADAL SERRANO MAS. ARCHITECT - ARCHI [O] LOGICS

RHINO USER MEETING DAY

ADOLFO NADAL SERRANO MAS. ARCHITECT - ARCHI[O]LOGICS

#example 1: create a series of points/spheres

RHINO USER MEETING DAY

ADOLFO NADAL SERRANO MAS. ARCHITECT - ARCHI [O] LOGICS

[Fig 5 Resultado del script]

RHINO USER MEETING DAY

ADOLFO NADAL SERRANO MAS. ARCHITECT - ARCHI[O]LOGICS

RHINO USER MEETING DAY

ADOLFO NADAL SERRANO MAS. ARCHITECT - ARCHI [O] LOGICS

II. PROGRAMACIN Y TOPOLOGA

[Fig 6. Elementos principales de la interfaz del editor]

RHINO USER MEETING DAY

ADOLFO NADAL SERRANO MAS. ARCHITECT - ARCHI[O]LOGICS

[Fig 8 Punto en espacio cartesiano R3: A(a1,a2,a3)]

[Fig 9. Vector v en espacio cartesiano R3: v(v1, v2,v3). El punto de apli-

[Fig 10 Punto en espacio cartesiano R3: A(a1,a2,a3)]

RHINO USER MEETING DAY

ADOLFO NADAL SERRANO MAS. ARCHITECT - ARCHI [O] LOGICS

(x,y) = (x1,y1) + k(v1,v2)

RHINO USER MEETING DAY

ADOLFO NADAL SERRANO MAS. ARCHITECT - ARCHI[O]LOGICS

dom(0)+ dom(0)+ dom(0)+ dom(0)+ dom(0)+ dom(0)+ dom(0)+

RHINO USER MEETING DAY

ADOLFO NADAL SERRANO MAS. ARCHITECT - ARCHI [O] LOGICS

RHINO USER MEETING DAY

ADOLFO NADAL SERRANO MAS. ARCHITECT - ARCHI[O]LOGICS

RHINO USER MEETING DAY

ADOLFO NADAL SERRANO MAS. ARCHITECT - ARCHI [O] LOGICS

TOPOLOGA DE LA GEOMETRA NURBS II

RHINO USER MEETING DAY

ADOLFO NADAL SERRANO MAS. ARCHITECT - ARCHI [O] LOGICS

I. GEOMETRA COMPUTACIONAL BSICA 2 - RECTAS Y CURVAS NURBS