DarwinBotsManual
Abrir la app EnglishEN

El editor de ADN

La pestaña ADN de la ficha de un bot: el texto con colores y autocompletado, la vista por genes y el modo de fichas, los avisos de lo que el motor lee distinto, la pila paso a paso de cada gen, las versiones, Probar, Evolucionar y el Laboratorio de genes.

El editor de ADN es la pestaña ADN de la ficha de cada bot (ver Bots: biblioteca y ficha). Ahí escribís el programa del bot, ves lo que el motor va a leer distinto de lo que parece, guardás versiones y probás cada cambio contra el anterior sin salir de la página.

Esta página explica la herramienta. Cómo se escribe un ADN está en el capítulo del lenguaje, empezando por La estructura de un bot.

Bots propios y bots del foro

Solo se editan tus bots. Los del foro (el Bestiario) se abren en modo lectura, con el aviso «Los bots del foro son de solo lectura: para cambiarlo, duplicalo como bot propio». Igual podés leerlos, recorrerlos por genes, probarlos y mirar el Laboratorio.

Para modificar uno:

  1. Hacé clic en Duplicar para editar, arriba a la derecha.
  2. Escribí el Nombre del bot nuevo, o dejalo vacío: se llama igual con « 2» al final.
  3. Hacé clic en Duplicar. Se abre la copia, ya editable.

La barra de arriba

De izquierda a derecha:

ControlQué es
Texto, Por genes y FichasLos tres modos de ver el ADN (texto, gen por gen o fichas).
v3La última versión guardada.
sin guardarAparece cuando el texto cambió desde esa versión.
4 avisosCuántos avisos hay abajo del texto.
PilaEnciende o apaga el visor de la pila paso a paso. En Fichas no cambia la vista: ahí la pila aparece al pasar el cursor por una ficha.
LaboratorioCambia el panel de la derecha por el de genes del Bestiario.
Nota de la versión y Guardar v4Guardan el texto como versión nueva (ver Versiones).

A la derecha del texto están los paneles Pila (si lo encendiste) y Probar; en tus bots siguen Evolucionar y Versiones, en Texto y en Por genes. En Fichas ese lugar lo ocupa la Paleta (ver Las fichas): Pila, Probar y Evolucionar no se ven, y Versiones sigue debajo. Con el Laboratorio encendido, en cualquier modo, ese lugar lo ocupa el panel de genes, y la pila, la paleta, Probar, Evolucionar y Versiones no se ven hasta que lo apagues: el botón Pila sigue en la barra, pero el panel espera.

El modo texto

Es un campo de texto común, con números de línea y colores. Escribir, seleccionar, copiar, pegar y deshacer funcionan como en cualquier campo del navegador. Las líneas largas no se cortan: el texto se desplaza a lo ancho.

Los colores distinguen cada clase de palabra:

Una palabra que no entra en ninguna clase queda sin color: suele ser un error, y el aviso correspondiente lo dice.

Los colores siguen las reglas del cargador del motor. Por ejemplo, una línea que empieza con def se pinta como definición aunque diga defensa, porque el motor la lee así (ver Variables con def).

Deshacer

Ctrl+Z (el deshacer del navegador) deshace lo que escribiste y también lo que hacen los botones mientras estás en el modo texto: completar una sysvar, Corregir un aviso, agregar un gen del Laboratorio o restaurar una versión. Cada uno entra en el deshacer como si lo hubieras escrito. Lo que cambiás en la vista por genes (apagar o encender un gen) no entra. En Fichas el deshacer es otro, propio de ese modo: ver Deshacer en Fichas.

Autocompletar sysvars

Cuando escribís un punto seguido de letras (.ey, o *.ey para leer), se abre una lista con hasta 12 nombres que coinciden. Cada uno muestra su dirección; tus variables de def aparecen primero y dicen privada.

La lista ordena primero el nombre exacto, después los que empiezan con lo que escribiste y al final los que lo contienen. Con .aim escrito, .aim va antes que .aimdx.

TeclaQué hace
↓ / ↑Recorren la lista.
TabAcepta el nombre elegido.
EnterTambién acepta, salvo que lo escrito ya sea un nombre completo: entonces cierra la lista y hace el salto de línea. Así, .up y Enter queda .up.
EscapeCierra la lista.

Un clic en un nombre de la lista también lo acepta. Dentro de un comentario la lista no aparece.

El autocompletado es solo para nombres con punto. Los operadores y los comandos se escriben enteros: si alguno queda mal escrito, lo marca un aviso.

La pila paso a paso

El botón Pila de la barra abre un visor que muestra, paso a paso, cómo corre el motor el gen donde está el cursor: qué queda en la pila de números y en la de verdadero o falso después de cada palabra, y qué escribe cada store. Sirve para ver de un vistazo por qué una condición da lo que da, sin adivinarlo leyendo el ADN. Cómo funcionan las dos pilas está en La pila entera y la booleana.

El panel aparece a la derecha, arriba de Probar y Versiones. El botón queda encendido o apagado en este navegador: al volver, sigue como lo dejaste. En el modo Fichas el panel no aparece; la pila se ve igual, al pasar el cursor por cada ficha (ver Las fichas).

El panel muestra:

La cabecera dice qué gen es (Gen 2, con su nombre si tiene una línea de comentario arriba) y si la condición dio verdadera o falsa. Si el gen tiene else, dice también qué rama corrió.

La tabla tiene una fila por palabra del gen:

ColumnaQué muestra
PalabraLa palabra del ADN, con sus colores.
EnterosLa pila de números después de esa palabra. Si hay más de 8, un «+k» cuenta las que no entran.
BooleanosLa pila de verdadero o falso: ✓ verdadero, ✗ falso.
NotaQué pasó: «escribe up (1) ← 50» en un store que escribió; «no corre con estos valores» en la primera fila de un bloque que el motor no ejecuta.

Las filas en gris son las que el motor no ejecuta con los valores de ejemplo: por ejemplo, el cuerpo del start cuando la condición es falsa. El motor no corre ese cuerpo, así que no hay pila que mostrar. Para verlo, cambiá los valores de ejemplo hasta que la condición dé verdadera.

Valores de ejemplo

Un gen puede leer sysvars con asterisco, como *.eye5. Su valor depende del bot que esté en la simulación, así que el visor necesita uno. Debajo del título de la pila aparece un campo por cada sysvar del vocabulario que el gen lee, con 0 al principio. Cambialo para ver cómo cambia la condición.

Estos valores:

Desde el inspector, la pestaña ADN puede abrir el editor con la memoria real del bot como valores de ejemplo: Abrir en el editor lleva el ADN a un bot nuevo, con la pila encendida y los valores que tenía el bot en ese momento, solo los de las sysvars que el ADN lee. Esos valores viven en la sesión: no se guardan como ejemplos del bot mientras no cambies ninguno. Si cambiás uno en la pila, la tabla entera (con los demás valores del inspector) pasa a ser ejemplo de ese bot.

Con *.eye5 en 80, la condición de este gen es verdadera, y el store escribe 50 en .up, la dirección 1:

cond *.eye5 50 > start 50 .up store stop
PalabraEnterosBooleanosNota
*.eye580
>✓
storeescribe up (1) ← 50

Con *.eye5 en 30, la condición es falsa: el start no corre, y su bloque sale en gris.

El resumen al pasar el cursor

Sin escribir nada, pasá el cursor por una sysvar o un operador del texto: aparece una tarjeta con su resumen del manual y el enlace Ver en el manual, que abre su página en otra pestaña. Sirve para leer qué hace .shootval sin irte del editor. Los comentarios no dan tarjeta, y si el manual del sitio no está disponible, no aparece (el editor sigue igual).

Los avisos

El motor no rechaza casi nada: una palabra que no entiende vale 0, en silencio, y el bot carga igual (ver Errores frecuentes). Por eso el editor revisa el texto mientras escribís, con las mismas reglas y las mismas tablas de palabras que usa el motor al cargar un bot, y te muestra abajo del texto cada palabra que el motor va a leer distinto de lo que parece.

Cada aviso tiene tres partes:

La revisión espera a que dejes de escribir un momento. Si el motor no pudo cargar, el editor lo dice («El control del ADN no está disponible») y no hay avisos.

Estos son todos los avisos, con un ejemplo de cada uno:

EjemploAvisoQué significa
.upp«.upp no es un sysvar: el motor lo lee como 0. ¿Quisiste decir .up?»Un nombre con punto que no existe, parecido a una sysvar. Corregir pone el nombre sugerido.
.zzqq«.zzqq no es un sysvar ni tiene def: el motor lo lee como 0.»Un nombre con punto que no se parece a nada.
.50«.50 no es un sysvar […]. ¿Quisiste decir la dirección 50? Las direcciones van sin punto.»Un número con punto. Corregir saca el punto (*.50 pasa a *50).
.otra, con su def más abajo«.otra se define más abajo: el motor lee el ADN en orden y acá vale 0. Subí el def.»El motor resuelve los nombres mientras lee: un def posterior no sirve. Ver Variables con def.
.Paso, con def paso«.Paso no coincide con su def: las variables privadas distinguen mayúsculas y acá vale 0.»Las sysvars no distinguen mayúsculas; tus variables sí.
up«up vale 0: ¿falta el punto? .up»El nombre de una sysvar sin punto. Corregir se lo agrega.
swapp«swapp no es un comando ni un número: vale 0. ¿Quisiste decir swap?»Una palabra a una letra de un comando, o con dos letras vecinas cambiadas de lugar (sotre), solo para palabras de 4 letras o más. Si hay dos candidatos, sugiere el que empieza igual: stor da store, no stop.
hola«hola no es un comando ni un número: vale 0 (¿texto sin la marca de comentario ')?»Cualquier otra palabra suelta. Muchas veces es un comentario sin su '.
store con un carácter invisible en el medio«… tiene un carácter invisible: no se reconoce como store y vale 0.»Pasa al copiar de páginas web o procesadores de texto. Corregir lo limpia.
ññ«… tiene caracteres invisibles o de otra codificación: vale 0.»Letras fuera del inglés básico, o una codificación rota.
50store«50store se lee como 50: «store» se pierde (¿falta un espacio?).»Un número con algo pegado. El motor toma el número y descarta el resto. Corregir inserta el espacio.
def nrg 5«La variable privada nrg tapa al sysvar .nrg en todo el bot.»Una variable con el nombre de una sysvar le gana en todo el ADN. Ver Variables con def.
defensa 50«Toda línea que empieza con «def» es una definición: defensa define la variable nsa. […]»El motor lee como def cualquier línea que empiece con esas letras. Si era texto, falta la '.
def x .up«El valor de un def tiene que ser un número: en def x, «.up» vale 0.»El valor de un def se escribe con cifras. Ver Variables con def.
ADN con def que empieza con 10«Con def, la primera palabra (10) no es de control de flujo y se pierde.»Una rareza heredada del original. Ver La estructura de un bot.
40000, o def pasos sin valor«El motor rechaza este ADN (error 6: un número fuera de ±32767 o un def mal formado).»El único caso en que el bot no carga. Ver La estructura de un bot.

Este ADN junta varios de esos errores:

def paso 30
cond
*.nrgg 100 >
start
.paso .up store
30 .upp store
30 up store
10 50store
stop
end

El editor marca *.nrgg (sugiere *.nrg), .upp (sugiere .up), up (falta el punto) y 50store (falta un espacio). Corregido:

def paso 30
cond
*.nrg 100 >
start
.paso .up store
30 .up store
30 .up store
10 50 store
stop
end

Debajo de los avisos del motor aparecen los del Laboratorio, que se explican en su sección.

La vista por genes

Por genes muestra el ADN como una tabla, un renglón por gen:

ColumnaQué muestra
GenEl número del gen, contado como lo cuenta el motor (ver Genes: cond, start, else y stop).
NombreLa línea de comentario que está justo arriba del gen, si hay una. Si no, «(sin nombre)».
OrigenDe dónde salió el gen, si vino del Laboratorio: «← Nombre del bot, gen 4».
Activosí o no. Un clic lo cambia.

Cada gen se despliega para ver su código, y un botón arriba pliega o despliega todos. Los genes con avisos llevan una marca con la cantidad.

Apagar un gen lo convierte en comentario: cada una de sus líneas empieza con '#off . El motor no lo ejecuta, pero queda en el texto y se vuelve a encender con un clic. Sirve para probar qué pasa sin un gen sin tener que borrarlo:

' Avanza
cond
start
10 .up store
stop
' Gira
'#off cond
'#off *.eye5 0 =
'#off start
'#off 30 .aimdx store
'#off stop
end

Acá el gen «Gira» está apagado: el bot solo avanza.

Las fichas

Fichas muestra el mismo ADN partido en palabras: cada palabra es una ficha, y las fichas van agrupadas por gen, igual que en Por genes. Sirve para cambiar, insertar y mover palabras sin reescribir la línea entera.

El texto sigue siendo la fuente. Cada acción de Fichas reemplaza palabras en el texto, y al volver a Texto está el mismo ADN. Las acciones de Fichas no tocan los comentarios ni la sangría: cambian la palabra o el lugar de la ficha y dejan el resto de la línea como estaba. La excepción son las líneas de comentario, def y las de los genes apagados, que se editan enteras con un clic.

Cada gen es una tarjeta con su número, su nombre y su origen. Dentro, cada línea de código es una fila de fichas. Entre dos fichas hay un +: un hueco donde cabe una palabra. Los + están tenues y se ven bien al pasar el cursor por la línea. A la izquierda aparece el rótulo de cada zona del gen (condición, cuerpo, else). Las líneas que están fuera de todo gen van en una tarjeta Fuera de genes, y un gen apagado se ve atenuado.

GestoQué pasa
Clic en una fichaSe convierte en un campo con su palabra. Escribí la nueva: debajo aparecen sugerencias, que recorrés con ↑ y ↓. Enter o Tab la aplica; Esc cancela.
Supr con el campo vacíoBorra la ficha, y el espacio que sobra.
Clic en un +Se abre un campo vacío en ese lugar. Enter inserta la palabra.
Enter en la última ficha de una líneaAbre una línea nueva con la misma sangría, con el cursor en su +.
Arrastrar una ficha a un +La mueve a ese lugar. Mientras arrastrás, el + de destino se marca. Si soltás fuera de todo +, no pasa nada.
Clic en una línea de comentario, def o de gen apagadoSe edita entera: cambia la línea completa.

La paleta

En Fichas, el panel de la derecha es la Paleta, con las palabras que podés poner en el ADN. Tiene un buscador arriba y estos grupos plegables: las sysvars, agrupadas por tema (cada una aparece como .x y como *.x); los operadores, por uso (flujo, aritmética y comparación, lógica, pila y stores); y Tus def, con las variables privadas del ADN. El buscador filtra todos los grupos a la vez.

Un clic en una palabra la pone en el ADN, en el último + que tocaste o en el lugar que dejó la última acción. Si todavía no tocaste ninguno, va al final del texto. Arrastrarla a un + la pone en ese lugar. La paleta no sabe en qué gen estás: en Fichas no hay «gen del cursor», así que la palabra va donde indica el último + o al final. Al pasar el cursor por una palabra aparece su resumen del manual, como en el resumen al pasar el cursor.

Con la Paleta en el lateral, Pila y Probar no se ven. Para probar el ADN, volvé a Texto o a Por genes. Versiones sigue visible en tus bots.

La pila al pasar el cursor

Al pasar el cursor por una ficha aparece un recuadro con las pilas que quedan después de esa palabra: los números, y los verdaderos o falsos con ✓ y ✗, como en el visor de la pila. La pila se calcula aunque el botón Pila esté apagado, y el botón no cambia nada en este modo.

Solo tienen pila las palabras que el motor ejecuta con los valores de ejemplo. En el cuerpo de un start que no corre, pasar el cursor no muestra nada, y tampoco si el ADN no carga o la traza no coincide con el texto. Los valores de ejemplo se cambian en el visor de la pila, en Texto o en Por genes.

Deshacer en Fichas

Ctrl+Z deshace y Ctrl+Y (o Ctrl+Mayús+Z) rehace, con el foco en la vista. Mientras editás una ficha no actúan: el campo tiene su propio deshacer.

Este deshacer es propio del modo. Guarda el ADN después de cada acción de Fichas (cambiar, insertar, mover o borrar una ficha, poner una palabra de la paleta, y también restaurar una versión o recuperar un borrador). Lo que hacés en Fichas no entra en el deshacer de Texto. El historial se vacía al cambiar de modo o de bot: al volver a Fichas, empieza desde el texto que hay.

Lo que Fichas no hace

Guardar versiones

Tus bots guardan su historia completa. Para guardar:

  1. Si querés, escribí una Nota de la versión («gira más rápido», «sin el gen de disparo»).
  2. Hacé clic en Guardar v4 (el número es el de la versión que se va a crear).

La versión guarda el texto exacto: un cambio en un comentario o en la sangría también es un cambio. Si no tocaste nada, la app no crea otra versión y te lo dice.

Lo que no guardaste no se pierde

Mientras escribís, el editor guarda un borrador del bot en este navegador. Si cambiás de pestaña, elegís otro bot o recargás la página, al volver encontrás tus cambios con el aviso «Tenés cambios sin guardar de la última vez: se recuperaron», y un botón Descartar los cambios por si no los querés.

Si mientras tanto el bot cambió por otro lado (por ejemplo, restauraste una versión desde la ficha), el editor no mezcla nada: te ofrece Recuperar los cambios o Descartar los cambios. Y si intentás cerrar la página con cambios sin guardar, el navegador te pide confirmación.

El panel Versiones

El panel de la derecha lista las versiones, de la más nueva a la más vieja, con su nota y su fecha:

Probar

Probar corre tu bot sin dibujarlo, a toda velocidad, y te dice cómo le fue. Si tiene una versión anterior, la corre también con las mismas semillas, para que la comparación sea justa.

CampoQué esPor defecto
CopiasCuántos bots iguales se siembran (de 1 a 50).10
CiclosCuánto dura cada corrida (de 10 a 200.000).5000
SemillasCuántas corridas, cada una con otro azar (de 1 a 16).3
ReglasF1: los ajustes de la liga F1, con costos. Sin costos: los valores con que arranca la interfaz clásica.F1
SemillaLa primera semilla; las demás salen de ella. Con la misma, la prueba da lo mismo.1
EscenarioCon algas: 15 algas para comer. Solo (sin algas): tus copias solas.Con algas

El botón dice qué se prueba y contra qué:

La prueba corre en segundo plano: podés seguir editando, cambiar de bot o cerrar el editor, y sigue avanzando. Mientras corre se ve el porcentaje y un botón Cancelar. Al terminar, el panel muestra una tabla con las dos versiones lado a lado, promediadas sobre las semillas:

FilaQué mide
SobrevivenCuántas de las copias del principio siguen vivas al final.
Hijos por copiaHijos directos de cada copia fundadora, en promedio (sin nietos).
Nacidos por copia (con nietos)Todos los nacidos de la especie, divididos por las copias.
Vivos al finalEl tamaño de la población al terminar.
Energía mediaLa energía por bot vivo al terminar.
ExtincionesEn cuántas semillas la especie desapareció.

Cada prueba queda anotada en el historial del bot.

Evolucionar

Evolucionar saca variantes de tu ADN con las mutaciones del motor, prueba cada una —y la base— con las mismas semillas, y te muestra cuál anduvo mejor. Sirve para ver si un cambio al azar ayuda o perjudica al bot. Aparece solo en tus bots, debajo de Probar, y no se ve en el modo Fichas ni con el Laboratorio encendido, igual que Probar (ver la barra).

Cada variante es una pasada de las mutaciones del motor sobre el ADN de la base, con el tipo y la intensidad que elegiste. Son las que describe Mutaciones: en vida, las puntuales (tipos de mutación), y en reproducción, los cambios que sufre el ADN al copiarse para el hijo. Las tasas del motor dicen con qué frecuencia pasa cada una. Cuatro tipos que vienen apagados en una simulación nueva (una segunda puntual, un segundo error de copia, la translocación y la amplificación) no corren aquí, ni las mutaciones Delta, que cambian las tasas del bot y no su ADN. Las variantes se generan en sims descartables del motor, no en tu simulación: tu bot no cambia hasta que adoptás una.

Los campos del panel:

CampoQué esPor defecto
VariantesCuántas variantes pedís, de 1 a 16. Pueden salir menos (ver más abajo).8
IntensidadCuán seguido muta el ADN. Con 4× las tasas del motor se dividen por 4, y con 16× por 16: una tasa de 5000 pasa a 1250 con 4× y a 312,5 con 16×. Con 1× rigen las tasas del bot tal cual.1×
MutacionesEn vida y en reproducción, Solo en vida o Solo en reproducción: qué familia de mutaciones corre.En vida y en reproducción
Copias y CiclosIgual que en Probar: cuántos bots iguales se siembran y cuánto dura cada corrida.10 y 5000

El escenario, las reglas y las semillas de cada prueba son los de Probar por defecto: con algas, reglas F1 y tres semillas. El panel no los muestra.

Cada ronda saca una semilla al azar, que se muestra debajo del botón junto con la intensidad.

Al hacer clic en Generar y probar, el motor arma las variantes y la prueba de la base y de cada una entra en la cola de trabajos. Mientras el motor las arma, el botón dice Generando…. Con la cola en marcha se ven el porcentaje y Cancelar, como en Probar. Podés seguir editando o cambiar de bot: la ronda sigue en la cola, y cada bot muestra su última ronda.

Cuando termina, la tabla muestra la Base (tu ADN, resaltada) y una fila por variante, numerada desde 1:

ColumnaQué mide
Genes cambiadosCuántos genes de la base cambió la variante: los cambiados, los agregados y los quitados.
SobrevivenCuántas de las copias del principio siguen vivas al final, en promedio sobre las semillas.
Hijos por copiaHijos directos de cada copia, en promedio (como en Probar).
Energía mediaLa energía por bot vivo al terminar.

Las variantes van ordenadas por Sobreviven y, en empate, por Hijos por copia. Cada una tiene tres botones:

Pueden salir menos variantes de las pedidas: las que quedan iguales al ADN original o iguales entre sí se descartan. Si el motor no saca ninguna distinta, el panel lo dice: «El motor no produjo variantes distintas; subí la intensidad».

Las variantes que no adoptás no se guardan como versiones. La ronda queda en el historial del bot, en Pruebas rápidas, con el chip Evolución. Cuando termina, el chip de trabajos de la barra superior lleva a Comparar (ver trabajos en segundo plano).

El Laboratorio

El Laboratorio sirve para armar un bot con genes de otros. Al encenderlo, el panel de la derecha pasa a Genes del Bestiario, con los genes de todos los bots del foro.

Hay dos formas de buscar:

solo autónomos deja solo los genes que no usan memoria propia: se pueden trasplantar sin arrastrar dependencias ni pisar direcciones de otros.

Cada gen de la lista dice de qué bot es, cuántas palabras tiene, si usa memoria propia y qué capacidades aporta. Un clic en el gen muestra su código debajo de la lista; el botón + lo agrega al final de tu ADN. El gen recuerda de dónde vino: lo ves en la columna Origen de la vista por genes y queda guardado con cada versión.

Los avisos del Laboratorio

Juntar genes de bots distintos tiene trampas, y el Laboratorio las avisa debajo del texto, con un arreglo de un clic cuando lo hay:

AvisoQué pasaArreglo
«El gen 3 (de X) lee la dirección 52, que en su bot escribe el gen 1.»El gen depende de un dato que en su bot original preparaba otro gen.+ gen 1: agrega el gen que falta.
«La dirección 60 la usan X, Y para cosas distintas […].»Dos genes de bots distintos usan la misma celda de memoria para cosas diferentes.Remapear direcciones: pasa las de los genes siguientes a direcciones libres, empezando por 971-990.
«El gen 2 (de X) usa números de gen literales en .delgene/.mkvirus que ya no apuntan a los genes de su bot.»Al cambiar de lugar, los números de gen escritos a mano apuntan a otro gen (ver .delgene y .mkvirus).Renumerar, o agregar los genes que faltan.
«Ningún gen reproduce: el bot no va a dejar hijos.»Informativo.—
«Ningún gen consigue energía (ni caza ni fotosíntesis).»Informativo.—

Los dos últimos solo aparecen cuando todo el ADN viene del Bestiario: de los genes que escribiste vos, el Laboratorio no sabe qué capacidades tienen.

En un bot del foro el Laboratorio se puede recorrer, pero + está apagado y los arreglos no aparecen: primero hay que duplicarlo.