Agregar una herramienta o ejemplo de literatura
En esta página
Una contribución útil puede ser pequeña: identificar un modelo publicado, localizar su código, mejorar un paso de configuración o informar una ejecución fallida. Un navegador es suficiente para proponer una fuente. Sigue el estándares compartidos.
Registros de catálogo#
Las fuentes editables son tools.csv, papers.csv, y examples.csv. Los ID son nombres estables en minúsculas separados por guiones; Las listas de ID utilizan punto y coma. Mantenga los ID de herramienta de ejemplo coherentes con los ID de herramienta de ejemplo.
Para una herramienta, registre su propósito, fuente y documentación oficiales, licencia del código fuente, términos de tiempo de ejecución/datos/activos separados, disponibilidad de la fuente y la fecha realmente verificada. No equipare una descarga gratuita con código abierto ni describa la disponibilidad del repositorio como evidencia de mantenimiento o ejecución. Incluya herramientas de escena y marcos de optimización cuando sea útil, identificando al mismo tiempo su función con precisión.
Para obtener una referencia, verifique el título, los autores, el año, el tipo de publicación y el DOI con un registro principal. Registre el acceso al texto completo y los pasajes realmente inspeccionados por separado de la verificación de metadatos. Un documento de software puede respaldar la descripción de la herramienta; un tutorial de aplicación necesita un modelo, método, ecuación, listado, punto de referencia o experimento identificable.
Por ejemplo, agregue una guía que brinde la pregunta de investigación, la conexión exacta del documento, la versión del código/archivo, el entorno, los términos de entrada, los comandos o la ruta de ejecución concreta, los archivos de salida esperados y las medidas de comparación. Explique las diferencias con el documento. Utilice un estado:
| Estado en CSV | evidencia requerida |
|---|---|
executed_adaptation |
Se ejecutó el código de enseñanza incluido; conservar los parámetros, el entorno, los resultados y las comprobaciones reales. Esto no afirma la reproducción en papel. |
upstream_instructions_checked |
Se inspeccionan los archivos fuente y las instrucciones de ejecución ascendentes; ejecución aún pendiente. |
access_pending |
Cita o artículo localizado, pero aún no se puede inspeccionar un artefacto necesario. Indique exactamente lo que falta. |
Utilice el plantilla de registro de ejecución para una nueva carrera. Una afirmación de que un resultado publicado fue reproducido también necesita un objetivo específico, métodos e insumos coincidentes, una comparación y tolerancia explícitas y una revisión científica humana. Mantener nuevos estudios sustanciales en sus propios repositorios de investigación.
Rutas de búsqueda para el catálogo completo.#
el inventario de rutas de papel a código registra los planos de construcción por separado del catálogo de ejemplos de enseñanza aceptados. Editar research/routes.json y preservar el registro de metadatos primario, la ubicación del papel, la relación código-papel, la versión inmutable cuando esté disponible, el acceso a las entradas, los comandos de construcción, el objetivo de comparación, la evidencia de ejecución y las lagunas no resueltas.
Un candidato de resultado en papel identifica qué reproducir; un ejemplo de software en papel o un tutorial relacionado tiene una relación más estrecha con la investigación. No actualice un estado de ejecución sin un registro de ejecución. Una comparación de objetivos publicados necesita insumos y métodos coincidentes, un observable y una tolerancia explícitos y evidencia numérica retenida. La revisión científica humana permanece separada.
correr python3 simulation-lab/research.py --write antes de regenerar el catálogo principal. Esto valida una ruta por herramienta de catálogo y genera las seis guías de dominio y el inventario de rutas descargable. Las nuevas investigaciones sustanciales pertenecen a un depósito de estudios; este inventario es un aprendizaje compartido y una planificación de la reproducción.
Intentos de código de autor y comparaciones numéricas.#
el campaña del candidato tiene un registro para cada una de las 21 herramientas seleccionadas. Mantenga las fallas originales, las versiones de publicación/documento, las configuraciones de entrada coincidentes, las salidas y hashes nativos y cualquier cambio en el código o el entorno. Una ejecución de código de autor, una replicación mantenida por terceros, una adaptación, un análisis de archivo y una comparación de documentos seleccionados tienen diferentes requisitos de evidencia.
Declare la regla observable y de comparación antes de producir el resultado numérico. La extracción revisada o la comparación post-hoc sigue siendo exploratoria incluso si le sigue una repetición determinista. Los objetivos en papel necesitan ubicaciones de origen y precisión o incertidumbre justificadas; un partido actual o un partido archivado debe conservar ese alcance más limitado. Verifique la convergencia y viabilidad del solucionador por separado del estado de salida del proceso. Registre la revisión científica humana como pendiente hasta que realmente se realice.
Editar reproductions/campaign.json y sus plantillas de guía originales, luego regenerar con python3 simulation-lab/reproduce.py --write. Comparta solo resultados explícitamente reutilizables y conserve los términos de tiempo de ejecución, modelo y activo por archivo. Nuevos ejemplos de uso exitosos executed_author_code o, para un objetivo seleccionado que pasa con su evidencia, published_target_compared. Uso de análisis de resultados guardados analysed_saved_output. Estos estados nunca afirman la reproducción completa del documento ni la aceptación humana.
Regenerar y comprobar#
Desde la raíz del centro, usando Python 3.10 o posterior:
python3 simulation-lab/reproduce.py --write
python3 simulation-lab/research.py --write
python3 simulation-lab/catalog.py --write
python3 simulation-lab/catalog.py
Esto verifica identificadores, referencias, fechas, formatos de enlaces de origen, archivos de guías locales y la actualización de los archivos generados. No contacta sitios externos ni verifica afirmaciones científicas. Sigue el instrucciones de construcción del sitio para comprobar los enlaces renderizados y el diseño al cambiar de página.
Envíe una solicitud de extracción con las fuentes que verificó, los comandos que ejecutó, los resultados, las limitaciones restantes, la asistencia material del agente y el ser humano responsable. No cargue archivos PDF de la biblioteca a menos que sus términos de redistribución lo permitan. Un DOI y una ubicación precisa del pasaje son suficientes para citar un artículo restringido; utilizar el ruta de solicitud de recursos cuando se necesita acceso.