este instructivo es para quien conoce una milpa o una parcela de maíz y quiere verla completa: el productor y la productora, el técnico o la técnica de campo, el extensionista, el estudiante que hace su servicio social o su tesis en una comunidad. No necesitas saber programación ni estadística; necesitas conocer tu unidad de producción y a la gente que la trabaja.

This guide is for whoever knows a milpa or a maize plot and wants to see it whole: farmers, field technicians, extension agents, students doing their social service or thesis in a community. You need no coding or statistics; you need to know your farm and the people who work it.

Sigue el mismo orden que la app: un capítulo por cada bloque de la barra superior, del 1 al 13, cada uno con su color. Todos los ejemplos usan un solo caso, el maíz criollo de San Andrés Calpan, Puebla, documentado por Díaz-José y colaboradores (2026) con 100 informantes entre 2022 y 2024. Así, los números de un capítulo son los que entran al siguiente. Si lo lees de corrido, al terminar habrás tejido, evaluado y proyectado un sistema real.

It follows the app’s order: one chapter for each block in the top bar, 1 to 13, each with its own colour. Every example uses a single case, the landrace maize of San Andrés Calpan, Puebla, documented by Díaz-José and colleagues (2026) with 100 informants between 2022 and 2024. So the numbers in one chapter are the ones that feed the next. Read it start to finish and you will have woven, assessed and projected a real system.

ConvencionesConventions

Los cinco recuadrosThe five boxes

Abrir Ratio MilpaOpening Ratio Milpa

Entra a hectortecumshe-ai.github.io/RatioMilpa desde la computadora, la tableta o el celular, o escanea el código QR de la página «Ratio Milpa en una página». Se descarga un solo archivo; después funciona sin internet mientras dejes la pestaña abierta, y puedes guardar la página (Ctrl + S) para usarla en la parcela sin señal.

Go to hectortecumshe-ai.github.io/RatioMilpa from a computer, tablet or phone, or scan the QR code on the “Ratio Milpa on one page” page. It downloads a single file; after that it works offline while the tab stays open, and you can save the page (Ctrl + S) to use it in the field with no signal.

La pantalla de inicioThe home screen

Las ayudas «?»The “?” helps

Junto a cada número importante hay un ?. Al tocarlo aparece qué significa, cómo se calcula y cómo leerlo, con un semáforo: verde (bien), ámbar (revisa) y rojo (atiende).

Next to every important figure there is a ?. Tap it to see what it means, how it is computed and how to read it, with a traffic light: green (good), amber (check) and red (act).

Vista productor y vista científicaProducer and scientist views

La vista productor muestra lo esencial en lenguaje sencillo; es la que describe este instructivo. La vista científica agrega tablas completas, fórmulas, correlaciones y validación. Puedes cambiar de vista en cualquier momento.

The producer view shows the essentials in plain language; it is the one this guide describes. The scientist view adds full tables, formulas, correlations and validation. You can switch at any time.

La ruta completaThe full route

Lo tuyo, lo sugerido y el ejemploYours, suggested and the example

Para que nunca confundas un ejemplo con tus propios datos, la app distingue tres cosas a simple vista:

So that you never mistake an example for your own data, the app tells three things apart at a glance:

¿Qué maíz siembras?Which maize do you sow?

Primero elige si tu maíz es nativo o criollo o mejorado o híbrido; mientras no elijas, la tarjeta dice «Sin elegir». Si es nativo, elige su raza entre las 64 reportadas para México en siete grupos raciales (CONABIO, 2020; clasificación de Sánchez et al., 2000), en la lista o tocando su chip; las marcadas con ° se describieron primero en el Caribe o Guatemala y también se han colectado en México. Si es mejorado, escribe su nombre tal como lo compras o como lo nombra la institución.

First choose whether your maize is native (landrace) or improved or hybrid; until you choose, the card reads “Not chosen”. If native, choose its race among the 64 reported for Mexico in seven racial groups (CONABIO, 2020; classification by Sánchez et al., 2000), in the list or by tapping its chip; those marked ° were first described in the Caribbean or Guatemala and have also been collected in Mexico. If improved, type its name as you buy it or as the institution names it.

Sistema y unidad de producciónProduction system and unit

El sistema dice cómo se cultiva el maíz: milpa (maíz, frijol, calabaza y otras especies), MIAF (milpa intercalada con árboles frutales), monocultivo, asociado con otro cultivo, en rotación, agroforestal o roza–tumba–quema, traspatio o forrajero con ganado; si no está el tuyo, agrégalo con ＋ ¿No está tu sistema? Agrégalo. Después eliges el tipo de unidad (milpa, parcela, unidad agrícola o mixta, parcela ejidal o comunal, parcela demostrativa u Otro), la superficie y el nombre del proyecto.

The system says how maize is grown: milpa (maize, bean, squash and other species), MIAF (milpa intercropped with fruit trees), monoculture, intercropped with another crop, in rotation, agroforestry or slash-and-burn, backyard or fodder with livestock; if yours is missing, add it with ＋ Your system is missing? Add it. Then choose the unit type (milpa, plot, crop or mixed farm, ejido or communal plot, demonstration plot or Other), the area and the project name.

Del país a la localidadFrom country to locality

Toca tu estado en el mapa o elígelo en la lista; luego el municipio y la localidad. La app reconoce 2,478 municipios y 54,357 localidades del INEGI, con su población de 2020, su altitud y su punto en el mapa. La región (Norte, Centro norte, Centro o Sur) se asigna sola. Al empezar, los tres campos dicen «— Elige… —» en gris.

Tap your state on the map or pick it from the list; then the municipality and the locality. The app knows 2,478 municipalities and 54,357 INEGI localities, with their 2020 population, altitude and map point. The region (North, North-central, Central or South) is set automatically. At the start the three fields read “— Choose… —” in grey.

Los datos de tu localidadYour locality’s data

Las cinco reglas básicas (5B)The five basic rules (5B)

Los productores de Calpan resumieron su saber en cinco reglas: buena tierra (preparar el terreno a tiempo para captar humedad), buena semilla (genética adaptada que aguante sin agua), buena siembra (arreglos que reducen la competencia por agua), buena alimentación (fertilización en los momentos clave) y buena vigilancia (seguir plagas, enfermedades, malezas y humedad). Para cada una marcas si se cumple en tu parcela: Sí, Parcial o No.

Calpan’s farmers summed up their knowledge in five rules: good soil (timely land preparation to capture moisture), good seed (adapted genetics that withstand drought), good sowing (arrangements that reduce competition for water), good nutrition (fertilising at key moments) and good watchfulness (monitoring pests, diseases, weeds and moisture). For each one you mark whether it is met on your plot: Yes, Partly or No.

Requerimientos innovadosInnovated requirements

Abajo agregas lo que la localidad ha innovado: escribe el requerimiento, elige la regla a la que pertenece, una descripción y la fuente (productor, asesor, investigación, programa), y toca Agregar requerimiento.

Below you add what the locality has innovated: write the requirement, choose the rule it belongs to, a description and the source (farmer, adviser, research, programme), and tap Add requirement.

Los 38 pasos de CalpanCalpan’s 38 steps

La app trae como preguntas los 38 pasos y 83 actividades de la Figura 4 del artículo, del diagnóstico de la parcela en diciembre a la cosecha y el balance económico. Ninguna viene contestada. Arriba ves cuántas respondiste, cuántas practicas (entran a la red) y cuántas no; la fecha de siembra dice «sin capturar» hasta que mueves su control, y entonces los pasos fijados en días después de la siembra se recorren solos. Los botones de las 5B filtran los pasos por regla.

The app brings the paper’s Figure 4 38 steps and 83 activities as questions, from plot assessment in December to harvest and economic balance. None comes answered. At the top you see how many you answered, how many you practise (they enter the network) and how many not; the sowing date reads “not entered” until you move its slider, and then steps set in days after sowing follow. The 5B buttons filter steps by rule.

Dentro de un pasoInside a step

Al abrir un paso ves sus actividades. Para cada una contesta Sí la practico o No; las que quedan «sin responder», con fondo rayado, no entran a la red. Con Todas sí o Todas no contestas el paso completo. Después revisa los cuadros de colores, que dicen si la actividad suma (verde) o resta (rojo) al suelo, al agua, a la atmósfera, a la vegetación y a la fauna, y corrígelos si en tu caso es distinto; y fija las fechas de las actividades principales (siembra, deshierbe, fertilización, corte, cosecha). Con + Actividad innovadora agregas lo que hoy hace diferente tu localidad, eligiendo los elementos que participan.

Opening a step shows its activities. For each one answer Yes, I do or No; those left “not answered”, with a striped background, do not enter the network. All yes or All no answers the whole step. Then check the coloured squares, which show whether the activity adds (green) or subtracts (red) for soil, water, atmosphere, vegetation and fauna, and correct them if your case differs; and set the dates of main activities (sowing, weeding, fertilising, cutting, harvest). With + Innovative activity you add what your locality does differently today, choosing the elements involved.

La ventana del ejemploThe example window

Cada bloque muestra el recuadro dorado «¿No sabes cómo llenarlo? Mira un caso publicado». Al tocar Ver el ejemplo publicado se abre una ventana sepia, con la marca de agua «EJEMPLO · NO SON TUS DATOS», con lo que se registró en Calpan para ese bloque y los pasos para llenarlo con tus datos. Es solo de consulta: al cerrarla tus campos siguen igual. Desde ahí también puedes entrar al modo ejemplo.

Every block shows the golden box “Not sure how to fill it in? See a published case”. Tapping See the published example opens a sepia window, with the “EXAMPLE · NOT YOUR DATA” watermark, showing what was recorded in Calpan for that block and how to fill it in with your data. It is for reference only: when you close it your fields stay the same. From there you can also enter example mode.

El índice de regeneraciónThe regeneration index

El medidor resume las ocho perillas en un número de 0 a 100 y una clase: degradante (menos de 25), convencional (25 a 49), en transición regenerativa (50 a 74) y regenerativo (75 o más). Junto está el perfil de regeneración, un radar donde se ve de un golpe qué principio está fuerte y cuál flojo.

The gauge sums up the eight knobs in a 0–100 number and a class: degrading (under 25), conventional (25–49), regenerative transition (50–74) and regenerative (75 or more). Next to it is the regeneration profile, a radar that shows at a glance which principle is strong and which weak.

Las ocho perillasThe eight knobs

Cada perilla responde una pregunta y trae un valor sugerido calculado con tus actividades del Bloque 4, con su motivo («4 actividades de labranza practicadas»). Mientras no la confirmes se ve punteada y gris, con la leyenda «Sugerido, sin confirmar». Si el valor corresponde a tu parcela, toca Aceptar sugerencia; si es distinto, muévela. Entonces dice «✓ Confirmado por ti». Mientras falten perillas, el índice se marca como provisional. Sin actividades en el Bloque 4 no hay sugerencia: la perilla dice «sin dato».

Each knob answers one question and brings a suggested value computed from your Block 4 activities, with its reason (“4 tillage activities practised”). Until you confirm it, it looks dashed and grey, labelled “Suggested, not confirmed”. If the value fits your plot, tap Accept suggestion; if not, move it. It then reads “✓ Confirmed by you”. While knobs are missing, the index is flagged provisional. Without Block 4 activities there is no suggestion: the knob reads “no data”.

Línea base y materia orgánicaBaseline and organic matter

La regeneración se ve con el tiempo. Toca Guardar como línea base hoy y vuelve en el siguiente ciclo: la app dice si el índice subió («el sistema se regenera») o bajó («el sistema se desgasta») y en qué perillas. Si tienes dos análisis de suelo, anota el % de materia orgánica de antes y de ahora: es la prueba más directa.

Regeneration shows over time. Tap Save as baseline today and come back next cycle: the app says whether the index rose (“the system is regenerating”) or fell (“the system is wearing out”) and on which knobs. If you have two soil tests, enter the % organic matter before and now: it is the most direct proof.

El índice y la matrizThe index and the matrix

Arriba ves el índice de riesgo (0 a 100), la capacidad adaptativa y de qué está hecha, cuántos riesgos son altos o muy altos y cuál es el mayor. Debajo, la matriz de riesgos: cada círculo dice cuántos riesgos caen en esa celda.

At the top you see the risk index (0 to 100), the adaptive capacity and what it is made of, how many risks are high or very high, and which is the highest. Below, the risk matrix: each circle shows how many risks fall in that cell.

Las perillas de cada riesgoEach risk’s knobs

Los riesgos están agrupados en climáticos (sequía, helada, granizo, lluvias intensas, ola de calor, ciclones), biológicos (plagas, enfermedades, malezas), de mercado (caída del precio, alza de insumos, intermediarismo), sociales (falta de mano de obra y relevo, pérdida del saber local, inseguridad), institucionales (retiro de apoyos, tenencia de la tierra) y de recursos naturales (erosión, escasez de agua). Para cada uno: desmarca si no aplica, y mueve probabilidad, impacto y el control que ya tienes.

Risks are grouped into climatic (drought, frost, hail, heavy rain, heatwave, cyclones), biological (pests, diseases, weeds), market (price fall, input cost rise, middlemen), social (labour shortage and succession, loss of local knowledge, insecurity), institutional (support withdrawal, land tenure) and natural resources (erosion, water scarcity). For each: untick it if it does not apply, and move likelihood, impact and the control you already have.

Diez categoríasTen categories

Cada elemento pertenece a una de diez categorías y participa en una o varias actividades. La barra junto a cada uno dice en cuántas actividades aparece. En Calpan son 63 elementos tomados del artículo: por ejemplo, productores de maíz criollo, proveedores de insumos, asesores técnicos, academia local (CBTA 255), CIMMYT, semilla criolla, rastrojo, humedad del suelo, El Niño y La Niña, grano y forraje.

Each element belongs to one of ten categories and takes part in one or more activities. The bar next to each shows how many activities it appears in. In Calpan there are 63 elements taken from the paper: for example, landrace maize farmers, input suppliers, technical advisers, local academia (CBTA 255), CIMMYT, landrace seed, stubble, soil moisture, El Niño and La Niña, grain and fodder.

Elementos expuestos al riesgoElements exposed to risk

Al final del bloque, la tarjeta Regeneración y riesgo en los elementos muestra qué elementos están más expuestos: el riesgo mayor de las amenazas que los afectan (Bloque 6).

At the end of the block, the Regeneration and risk in the elements card shows which elements are most exposed: the highest risk among the hazards affecting them (Block 6).

Precio por hectáreaPrice per hectare

Elige una categoría con las pestañas. Para cada elemento anota el precio unitario, la unidad (kg, L, jornal, ha) y la cantidad por hectárea; la app calcula el $/ha. En Recursos financieros están el costo de producción, los ingresos netos y el precio de venta: con ellos se calculan el margen del índice de Sarandón y el ingreso neto de la prospectiva.

Choose a category with the tabs. For each element enter the unit price, the unit (kg, L, day’s labour, ha) and the quantity per hectare; the app computes $/ha. Financial resources holds production cost, net income and sale price: they feed the margin in Sarandón’s index and net income in the outlook.

El valor en cuatro dimensionesValue in four dimensions

Califica cada elemento de 0 a 5 en valor económico, de uso, cultural y ecológico. Arriba, las perillas de pesos dicen cuánto cuenta cada dimensión. Si no calificas, la app usa el valor estructural: qué tanto participa el elemento en las actividades.

Rate each element from 0 to 5 on economic, use, cultural and ecological value. At the top, the weight knobs say how much each dimension counts. If you do not rate, the app uses the structural value: how much the element takes part in the activities.

Tu catálogo en CSVYour catalogue as CSV

Con Descargar catálogo (CSV) guardas tus elementos, precios y valores en una hoja de cálculo; con Cargar catálogo (CSV) los traes a otro proyecto.

With Download catalogue (CSV) you save your elements, prices and values to a spreadsheet; with Load catalogue (CSV) you bring them into another project.

El botón «Tejer el sistema»The “Weave the system” button

Toca Tejer el sistema. La app arma la red y te lleva al Tablero. Junto al botón ves cuántos nodos, vínculos y actividades tiene tu sistema y su densidad. Debajo, el modelo del sistema: el entorno (clima y perturbaciones), los agentes, el Stack de conocimiento, el manejo, los insumos, los recursos, las instituciones, las políticas y los productos, con sus flechas.

Tap Weave the system. The app builds the network and takes you to the Dashboard. Next to the button you see how many nodes, links and activities your system has and its density. Below, the system model: the environment (climate and disturbances), agents, knowledge Stack, management, inputs, resources, institutions, policies and products, with their arrows.

El resumen de arribaThe summary at the top

Los indicadores de arriba dicen el tamaño de la red (nodos y vínculos), su densidad, el agrupamiento y el camino medio, la modularidad Q y la sostenibilidad media. Debajo, la tarjeta Regeneración y riesgo del sistema trae los índices de los bloques 5 y 6, el radar y la matriz.

The top indicators give the network size (nodes and links), its density, clustering and mean path, modularity Q and mean sustainability. Below, the System regeneration and risk card brings the indices from blocks 5 and 6, the radar and the matrix.

La red del sistemaThe system network

Cada punto es un elemento, con el color de su categoría; su tamaño depende de la medida que elijas arriba: grado ponderado (cuánto se relaciona), intermediación (cuánto sirve de puente), vector propio (si se relaciona con los importantes) o cercanía. Toca un nodo para ver solo sus relaciones. Como los productores participan en casi todo, la casilla Ocultar al nodo omnipresente deja ver la estructura interna.

Each dot is an element, coloured by category; its size depends on the measure you choose at the top: weighted degree (how related it is), betweenness (how much it bridges), eigenvector (whether it relates to the important ones) or closeness. Tap a node to see only its relations. Since farmers take part in almost everything, the Hide the omnipresent node box reveals the inner structure.

Correlaciones de un elementoOne element’s correlations

Elige un elemento en la lista y verás con cuáles aparece junto en las mismas actividades (barras verdes) y con cuáles casi nunca coincide (barras rojas).

Choose an element in the list to see which ones appear together with it in the same activities (green bars) and which hardly ever coincide (red bars).

El cladograma: ¿quién está cerca de quién?The cladogram: who is close to whom?

El cladograma agrupa a los elementos según su cercanía en la red: cada uno se une primero con su vecino más cercano. Lee el árbol de izquierda a derecha: las ramas cortas son elementos muy ligados, que conviene atender juntos. Elige ver solo actores, actores e instituciones, o todos los elementos. Debajo, la tabla dice el vecino más cercano de cada uno; ↔ marca a los vecinos mutuos.

The cladogram groups elements by closeness in the network: each first joins its nearest neighbour. Read the tree left to right: short branches are tightly linked elements, best looked after together. Choose to see actors only, actors and institutions, or all elements. Below, the table gives each one’s nearest neighbour; ↔ marks mutual neighbours.

El calendario circularThe circular calendar

El año es un círculo; cada anillo es un tipo de actividad y cada arco, un paso con sus fechas. La aguja marca hoy y el centro anuncia la siguiente actividad. Toca un arco para abrir su paso en el Bloque 4; en la leyenda, para filtrar.

The year is a circle; each ring is an activity type and each arc a step with its dates. The needle marks today and the centre announces the next activity. Tap an arc to open its step in Block 4; tap the legend to filter.

Índice de sostenibilidad y SarandónSustainability index and Sarandón

El índice de sostenibilidad (IS) va de 0 a 1: 0.5 es neutro, arriba la actividad suma y abajo resta. El índice general de sostenibilidad de Sarandón (ISGen) promedia tres dimensiones en escala de 0 a 4: económica (IK), ecológica (IE) y sociocultural (ISC). El sistema es sostenible si ISGen es mayor que 2 y ninguna dimensión queda por debajo de 2.

The sustainability index (IS) goes from 0 to 1: 0.5 is neutral, above it the activity adds and below it subtracts. Sarandón’s general sustainability index (ISGen) averages three dimensions on a 0–4 scale: economic (IK), ecological (IE) and socio-cultural (ISC). The system is sustainable if ISGen is above 2 and no dimension falls below 2.

Los 17 ODSThe 17 SDGs

La rueda y las tarjetas muestran el grado de cumplimiento de cada Objetivo de Desarrollo Sostenible con evidencia de tu sistema. «Sin dato» no es incumplimiento: significa que tus datos no dicen nada de ese objetivo.

The wheel and cards show how far each Sustainable Development Goal is met with evidence from your system. “No data” is not failure: it means your data says nothing about that goal.

Huella de carbonoCarbon footprint

Captura los litros de diésel, los kilos de nitrógeno y de urea por hectárea y el rendimiento: la app calcula los kilos de CO₂ equivalente por hectárea y por tonelada con los factores del IPCC. Si dejas los campos vacíos, la huella aparece como «—».

Enter litres of diesel, kilos of nitrogen and urea per hectare and the yield: the app computes kilos of CO₂ equivalent per hectare and per tonne with IPCC factors. If you leave the fields empty, the footprint shows as “—”.

Deseable, tendencial y no deseadoDesirable, trend and undesired

Cada escenario combina el precio del producto, el costo de los insumos, el calentamiento, la frecuencia de años extremos, la mano de obra familiar disponible y la adopción de tus actividades innovadas. La app grafica diez indicadores con marcas en los años 2, 5 y 10: rendimiento, precio, costo, ingreso bruto ÷ costo, ingreso neto, mano de obra, adopción, sostenibilidad, regeneración y riesgo. Debajo, las potencialidades y las perspectivas no deseadas se escriben solas con tus resultados.

Each scenario combines product price, input cost, warming, frequency of extreme years, available family labour and adoption of your innovated activities. The app plots ten indicators marked at years 2, 5 and 10: yield, price, cost, gross income ÷ cost, net income, labour, adoption, sustainability, regeneration and risk. Below, the potentials and undesired prospects are written from your results.

Los supuestosThe assumptions

La tabla de supuestos es editable. Lo que tiene base publicada lleva su fuente (calentamiento, IPCC 2018; pérdida de rendimiento por grado, Zhao y colaboradores 2017; curva de adopción, Rogers 2003); el resto lleva la etiqueta ◆ de supuesto. Contrasta precios y mano de obra con el Censo Agropecuario y la ENOE del INEGI y con los precios del SIAP de tu municipio.

The assumptions table is editable. What has a published basis carries its source (warming, IPCC 2018; yield loss per degree, Zhao and colleagues 2017; adoption curve, Rogers 2003); the rest is flagged ◆ as an assumption. Check prices and labour against INEGI’s Agricultural Census and ENOE and SIAP prices for your municipality.

Imprimir, exportar y guardarPrint, export and save

Los botones de CSV descargan las tablas de actividades, nodos, vínculos, calendario, ODS y cladograma para trabajarlas en una hoja de cálculo. Empezar de nuevo borra el proyecto de este navegador: guárdalo antes.

The CSV buttons download the activities, nodes, links, calendar, SDG and cladogram tables for use in a spreadsheet. Start over erases the project from this browser: save it first.

Cómo se arma el estudio nacionalHow the national study is put together

1. Cada encuestador llena una localidad, de preferencia con varios productores, y la guarda en el Bloque 13 con ⤓ Guardar proyecto: obtiene un archivo .milpa.json con el nombre de la localidad.
2. Each surveyor fills in one locality, ideally with several farmers, and saves it in Block 13 with ⤓ Save project: the result is a .milpa.json file named after the locality.
3. Quien coordina reúne los archivos (memoria USB, correo, carpeta compartida) y en el Bloque 14 toca ＋ Agregar archivos de localidades; puede elegir muchos a la vez.
4. The coordinator gathers the files (USB stick, e-mail, shared folder) and in Block 14 taps ＋ Add locality files; many can be chosen at once.
5. Con ⤓ Exportar atlas se guarda todo en un solo archivo .atlas.json, que se puede compartir o seguir ampliando; los CSV de localidades y de prácticas se abren en una hoja de cálculo.
6. With ⤓ Export atlas everything is saved in a single .atlas.json file that can be shared or extended; the localities and practices CSVs open in a spreadsheet.

Qué muestra el atlasWhat the atlas shows

• Comparación por región (Norte, Centro norte, Centro y Sur): número de localidades y medias de sostenibilidad, regeneración, riesgo y prácticas respondidas «sí».
• Comparison by region (North, North-central, Central and South): number of localities and means of sustainability, regeneration, risk and practices answered “yes”.
• Prácticas del cuestionario base: para cada actividad, el porcentaje de localidades que la practican, nacional y por región. Puedes ordenarlas por paso, de la más a la menos practicada o al revés.
• Baseline questionnaire practices: for each activity, the share of localities that practise it, nationally and by region. Sort them by step, most practised or least practised.
• Maíces sembrados (razas y mejorados), innovaciones de las localidades y la red nacional del conocimiento del maíz.
• Maizes sown (races and improved), localities’ innovations and the national network of maize knowledge.

Diez pasosTen steps

1. Reúne a la gente. Productores con experiencia, quien hereda la parcela, el asesor técnico. El Stack de Calpan se armó con 100 informantes en tres ciclos.
2. Bring people together. Experienced farmers, whoever will inherit the plot, the technical adviser. Calpan’s Stack was built with 100 informants over three cycles.
3. Bloque 1. Indica si el maíz es nativo (y su raza) o mejorado, el sistema y la superficie.
4. Block 1. State whether the maize is native (and its race) or improved, the system and the area.
5. Bloque 2. Ubica la localidad.
6. Block 2. Locate the locality.
7. Bloque 3. Revisa con la gente si se cumplen las 5B y anota los requerimientos que la localidad ha innovado.
8. Block 3. Check with people whether the 5B are met and record the requirements the locality has innovated.
9. Bloque 4. Responde «sí» o «no» a cada actividad del cuestionario base, pon las fechas principales y agrega las actividades propias de la localidad.
10. Block 4. Answer “yes” or “no” to each baseline activity, set the main dates and add the locality’s own activities.
11. Bloques 5 y 6. Ajusta las perillas de regeneración y de riesgo con lo que vive la localidad; guarda la línea base.
12. Blocks 5 and 6. Adjust the regeneration and risk knobs to what the locality lives; save the baseline.
13. Bloque 7. Revisa que estén todos los elementos; agrega los que falten y elígelos en sus actividades.
14. Block 7. Check all elements are there; add the missing ones and choose them in their activities.
15. Bloque 8. Anota precios, costos e ingresos por hectárea y califica el valor.
16. Block 8. Enter prices, costs and income per hectare and rate value.
17. Bloque 9. Teje el sistema y léelo en los bloques 10 a 12 con la gente que lo vive.
18. Block 9. Weave the system and read it in blocks 10–12 with the people who live it.
19. Bloque 13. Imprime el informe y guarda el proyecto: el archivo .milpa.json es el que se envía a quien coordina el atlas (Bloque 14).
20. Block 13. Print the report and save the project: the .milpa.json file is the one sent to the atlas coordinator (Block 14).

Guía de entrevista, bloque por bloqueInterview guide, block by block

Preguntas abiertas para una plática con productores. No hace falta seguir el orden; lo importante es que cada respuesta quede anotada con quién la dijo y cuándo.

Open questions for a conversation with farmers. The order is not important; what matters is that every answer is written down with who said it and when.

Hoja de campo 1: pasos y actividadesField sheet 1: steps and activities

Imprime esta página y llénala a mano en la parcela; luego pásala al Bloque 4.

Print this page and fill it in by hand on the plot; then transfer it to Block 4.

Cultivo o especie: ______________________   Localidad: ______________________   Fecha: ___________

Crop or species: ______________________   Locality: ______________________   Date: ___________

T = tradicional, I = innovada.

T = traditional, I = innovated.

Hoja de campo 2: regeneraciónField sheet 2: regeneration

Marca con la gente un número del 0 al 4 en cada fila y anota por qué; luego pásalo a las perillas del Bloque 5.

Mark a number from 0 to 4 on each row with the people and write why; then transfer it to the Block 5 knobs.

Suma: ______ ÷ 32 = IR ______   Materia orgánica del análisis de suelo: ______ %   Año: ______

Sum: ______ ÷ 32 = IR ______   Organic matter from soil test: ______ %   Year: ______

Hoja de campo 3: riesgosField sheet 3: risks

Para cada amenaza: probabilidad (1 rara vez … 5 casi cada año), impacto (1 casi nada … 5 se pierde todo) y control (0 nada … 3 bien controlado). Tacha las que no aplican.

For each hazard: likelihood (1 rarely … 5 almost every year), impact (1 almost nothing … 5 everything lost) and control (0 none … 3 well controlled). Cross out those that do not apply.

Hoja de campo 4: costos, precio y valorField sheet 4: costs, price and value

Por hectárea (o por colmena, o por cabeza) y por ciclo. Luego pásalo al Bloque 8.

Per hectare (or per hive, or per head) and per cycle. Then transfer it to Block 8.

Valor de los elementos principales, del 0 al 5:

Value of the main elements, from 0 to 5:

1. 1
   MaízMaizeIndica si tu maíz es nativo (y su raza) o mejorado, y su sistema.State whether your maize is native (and its race) or improved, and its system.
2. 2
   RegiónRegionUbica tu parcela hasta la localidad del INEGI.Locate your plot down to the INEGI locality.
3. 3
   RequerimientosRequirementsRevisa las 5B y agrega lo que tu localidad ha innovado.Review the 5B and add what your locality has innovated.
4. 4
   ManejoManagementMarca lo que practicas, agrega innovaciones y pon fechas.Tick what you practise, add innovations and set dates.
5. 5
   RegeneraciónRegenerationAjusta las ocho perillas y guarda una línea base.Adjust the eight knobs and save a baseline.
6. 6
   RiesgosRisksMueve probabilidad, impacto y control de cada riesgo.Move likelihood, impact and control for each risk.
7. 7
   ElementosElementsRevisa actores, insumos y recursos; agrega los que falten.Review actors, inputs and resources; add the missing ones.
8. 8
   Precio y valorPrice and valueAnota precios por hectárea y califica el valor de 0 a 5.Enter prices per hectare and rate value from 0 to 5.
9. 9
   FormulaciónFormulation⚙ Formular: la app teje la red del sistema.⚙ Formulate: the app weaves the system network.
10. 10
    TableroDashboardLee quién sostiene el sistema y quién está cerca de quién.Read who holds the system together and who is close to whom.
11. 11
    SostenibilidadSustainabilityRevisa qué suma, qué resta y el índice de Sarandón.See what adds, what subtracts and Sarandón’s index.
12. 12
    ProspectivaOutlookCompara los tres futuros y ajusta los supuestos.Compare the three futures and adjust the assumptions.
13. 13
    InformeReportImprime, exporta y guarda el archivo de tu localidad.Print, export and save your locality’s file.
14. 14
    AtlasAtlasJunta los archivos de las localidades y lee el país.Combine locality files and read the country.

Cómo citarHow to cite

Mojica-Zárate, H. T., y Díaz-José, O. (2026). Ratio Milpa: el conocimiento local del maíz en México como sistema complejo adaptativo (Versión 0.1.0) [Software]. Zenodo. https://doi.org/10.5281/zenodo.23432656

Mojica-Zárate, H. T., & Díaz-José, O. (2026). Ratio Milpa: local maize knowledge in Mexico as a complex adaptive system (Version 0.1.0) [Software]. Zenodo. https://doi.org/10.5281/zenodo.23432656

Fuentes principalesMain sources

• CONABIO. 2020. Razas de maíz de México. Comisión Nacional para el Conocimiento y Uso de la Biodiversidad.
• Sánchez JJ, Goodman MM, Stuber CW. 2000. Isozymatic and morphological diversity in the races of maize of Mexico. Economic Botany 54(1): 43–59.
• Díaz-José O, Mojica-Zárate HT, Díaz-José J, Vilaboa-Arróniz J. 2026. El conocimiento agrícola local: el stack del maíz criollo en Calpan, Puebla. Agricultura, Sociedad y Desarrollo 23(3). https://doi.org/10.22231/asyd.v23i3.1822
• Mojica Zárate HT. 2017. Modelo y procedimiento para la gestión estratégica integrada de los recursos naturales en territorios áridos con orientación agroproductiva. Tesis doctoral, Universidad Central «Marta Abreu» de Las Villas.
• CONABIO. 2020. Razas de maíz de México. · INEGI. 2020. Censo de Población y Vivienda; Catálogo Único de Claves Geoestadísticas.
• Sarandón SJ. 2002. El desarrollo y uso de indicadores para evaluar la sustentabilidad de los agroecosistemas. En: Sarandón SJ (ed.), Agroecología: el camino hacia una agricultura sustentable. Ediciones Científicas Americanas, La Plata: 393–414.
• Newton P, et al. 2020. What is regenerative agriculture? Frontiers in Sustainable Food Systems 4: 577723. · Schreefel L, et al. 2020. Regenerative agriculture – the soil is the base. Global Food Security 26: 100404.
• IPCC. 2014. Climate Change 2014: Impacts, Adaptation, and Vulnerability (SPM). · IPCC. 2018. Global Warming of 1.5 °C (SPM). · ISO 31000:2018 · IEC 31010:2019.
• Zhao C, et al. 2017. Temperature increase reduces global yields of major crops in four independent estimates. PNAS 114(35): 9326–9331. · Rogers EM. 2003. Diffusion of innovations, 5.ª ed.

Página legalLegal page