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.

Ver código fuente en GitHub