Download Tiko`n Documentation

Tiko’n Documentation
Release 1.0.2
Julien Malard
02, 2017
Contents
1
Introducción
1
2
Instalación
2.1 Si sabes lo que estás haciendo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
2.2 Si no sabes lo que estás haciendo (para Windows) . . . . . . . . . . . . . . . . . . . . . . . . . . .
3
3
3
3
Uso
3.1 Uso normal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
3.2 Uso intenso . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
3.3 Desarrollo profundo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
7
7
7
8
4
Ejemplos
9
5
Documentación completa
5.1 RAE (Redes Agroecológicas)
5.2 Clima y meteorología (Clima)
5.3 Manejo . . . . . . . . . . . .
5.4 Cultivo . . . . . . . . . . . .
5.5 Parcela . . . . . . . . . . . .
5.6 Paisaje . . . . . . . . . . . .
5.7 Cosas complicadas . . . . . .
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
11
11
11
11
12
12
12
12
6
Publicaciones
13
7
Agradecimientos
7.1 Autores del código . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
7.2 Traductores . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
7.3 Instituciones afiliadas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
15
15
15
15
i
ii
CHAPTER
1
Introducción
Tiko’n es un programa para desarrollar modelos agroecológicos de manera sencilla, reproducible y divertida.
Este paquete está en modo de desarrollo activo. La documentación de muchos módulos ya está disponible. El resto irá
apareciendo aquí con el tiempo.
1
Tiko’n Documentation, Release 1.0.2
2
Chapter 1. Introducción
CHAPTER
2
Instalación
Contenido
• Instalación
– Si sabes lo que estás haciendo
– Si no sabes lo que estás haciendo (para Windows)
* Instalación de Python
* Instalación de paquetes adicionales
* Uso con PyCharm
Si sabes lo que estás haciendo
¡Felicitaciones! Tiko’n necesita Python 3.5+, NumPy, SciPy, y Matplotlib. Tiko’n sí mismo es un paquete de Python
que se puede conseguir con
pip install tikon.
Si no sabes lo que estás haciendo (para Windows)
Esto es para Windows. Es un poco complicado, así que si tienes dificultades no dudes en pedirme ayuda (|correo|)
para que te ahorres los dolores de cabeza que yo ya pasé.
Si estás usando Linux, no tengo idea cómo funciona pero me han dicho que es bastante más fácil que para los pobres
que todavía seguimos con Windows.
Si estás usando un Mac, no tengo idea cómo funciona y parece bastante más difícil que para un Windows.
3
Tiko’n Documentation, Release 1.0.2
Instalación de Python
Primer que todo, hay que instalar Python. Puedes cargar la versión la más recién de aquí (https://www.python.org/
downloads).
Instalación de paquetes adicionales
El problema con Python es que, mientras que es mucho más fácil para leer o escribir que otras lenguas (si no me
crees, busca Fortran o C++), también es bastante más lento. Por eso, códigos Python que involucran muchos cálculos
numéricos se escriben con extensiones en Fortran o en C para aumentar la velocidad un poco. No te preocupes,
¡que Tiko’n no tiene nada en Fortran o C! Es puro Python. Pero desafortunadamente para sus funciones matemáticas
necesita unos paquetes adicionales de Python (NumPy, SciPy y Matplotlib), y ellos, sí tienen extensiones raras.
Si sabes cómo instalar estas y compilar código C directamente en tu computadora, perfecto. Si, como la mayoría de la
gente normal, no lo sabes, haz lo siguiente:
1. Ir al http://www.lfd.uci.edu/~gohlke/pythonlibs
2. Descargar las versiones más recientes de numpy+mkl, scipy, matplotlib y pymc.
Tienes que
tener cuidado de escoger la buena versión para tu computadora.
Todas estas tienen la forma
general nombreDelPaquete-versiónDelPaquete-versiónDePython- númeroDeBits.whl.
Asegúrate de descargar el archivo apropiado (si no sabes el número de bits de du programa Python (y NO
él de tu computadora), es casi seguramente 32). Por ejemplo, para SciPy en Python 3.6 con un Python de 32
bits, escogerías scipy-0.18.1-cp36-cp36m-win32.whl.
3. ¡Bravo! Ahora, hay que instalar los paquetes que acabaste de cargar. Va a la línea de comanda (se encuentra en
la lista de aplicaciones de tu computadora) y escribe el siguiente:
pip install C:\Users\jeanne\Downloads\numpy1.11.
3+mklcp36cp36mwin32.whl
Después, pulse “Intro”. Por supuesto, tienes que cambiar la última parte para corresponder a dónde tú guardaste
el paquete NumPy en tu computador cuando lo descargaste. Ver la imagen para un ejemplo:
Ejemplo_instalación_paquetes.png
4. Repetir etapa 3 con SciPy y después con Matplotlib y por fin con PyMC.
5. ¡Casi terminado! Ahora, solamente tienes que ir a https://www.microsoft.com/es-ES/download/details.aspx?
id=53840 y descargar el C++ 2015 redistributable (toma la versión terminando el ...x86.exe si
tienes Python de 32 bits (si no lo sabes, toma éste) y en ...x64.exe si tienes Python de 64 bits. Después,
instálalo. Por razones obscuras, SciPy no funciona en Windows sin éste.
6. Y por fin, por supuesto, instalar Tiko’n sí mismo en la línea de comanda así:
pip install tikon
Bueno, si todo esto te parece un poco incómodo, estoy de acuerdo. Hay una nueva lengua de programación
llamada Julia que es tan rápida como C y tan intuitiva como Python, y por lo tanto no tiene nada de
extensiones ajenas en Fortran o en C. Pero me di cuenta demasiado tarde y ahora no voy a reescribir todo
el programa de Tiko’n en Julia (después de todo, tengo una tesis que escribir). Lo siento.
4
Chapter 2. Instalación
Tiko’n Documentation, Release 1.0.2
Uso con PyCharm
Para personas que piensan hacer más con Tiko’n que usar el IGU, recomiendo muy fuertemente que usen la versión
Comunitaria (gratis) de PyCharm (https://www.jetbrains.com/pycharm). PyCharm es para Python lo que Word es para
documentos de texto, y te salvará de muchos dolores de cabeza (por una cosa, te dice dónde has hecho un error).
Es bastante fácil usar PyCharm; después de instalarlo, simplemente hay que abrir la copia local de Tiko’n en el editor
y empezar a escribir tu código. Si quieres contribuir a Tiko’n, puedes usar PyCharm para conectar tu versión con la
página de Tiko’n en GitHub (así siempre tendrás la versión más recién). Contáctame ([email protected])
si estás interesada.
2.2. Si no sabes lo que estás haciendo (para Windows)
5
Tiko’n Documentation, Release 1.0.2
6
Chapter 2. Instalación
CHAPTER
3
Uso
Uso normal
El Interfaz (IGU) de Tiko’n
Escribir la descripción aquí.
El API (librería Python)
Escribir la descripción aquí.
Uso intenso
Estructura general
La estructura general del programa Tiko’n.
Nuevas ecuaciones
Cómo agregar nuevos tipos de ecuaciones a Tiko’n.
Nuevos Organismos
Cómo agregar nuevos tipos de Organismos a Tiko’n.
7
Tiko’n Documentation, Release 1.0.2
Nuevos modelos de cultivo
Cómo agregar un nuevo modelo de cultivo a Tiko’n.
Desarrollo profundo
Poner instrucciones aquí.
8
Chapter 3. Uso
CHAPTER
4
Ejemplos
Escribir ejemplos aquí.
9
Tiko’n Documentation, Release 1.0.2
10
Chapter 4. Ejemplos
CHAPTER
5
Documentación completa
Aquí sigue la documentación de todo el programa Tiko’n con todos sus módulos complejos y oscuros.
RAE (Redes Agroecológicas)
RAE (Redes AgroEcológicas)
Organismos
Instancias de Organismos
Insectos
Planta
Enfermedades
Clima y meteorología (Clima)
Poner la documentación aquí.
Manejo
Poner la documentación aquí.
11
Tiko’n Documentation, Release 1.0.2
Cultivo
Escribir la documentación aquí.
Parcela
Paisaje
Cosas complicadas
Coso
Simulable
Matemáticas
Distribuciones
Calib
Arte
Incert
Unidades
12
Chapter 5. Documentación completa
CHAPTER
6
Publicaciones
13
Tiko’n Documentation, Release 1.0.2
14
Chapter 6. Publicaciones
CHAPTER
7
Agradecimientos
Tiko’n es un proyecto de fuente abierta. Las personas e instituciones siguientes hicieron posible su desarrollo.
Autores del código
• Julien Malard (Sitio internet)
Traductores
Cuando se habrán traducido Tiko’n y su documentación, los agradecimientos irán aquí.
Instituciones afiliadas
Tiko’n se desarrolla en colaboración con las instituciones siguientes:
15
Tiko’n Documentation, Release 1.0.2
16
Chapter 7. Agradecimientos