The RAND Ontological Model for Assessing Nuclear Crisis Escalation Risk (ROMANCER)
User Guide for Version 1.0
ToolPublished Dec 16, 2025
User Guide for Version 1.0
ToolPublished Dec 16, 2025
The RAND Ontological Model for Assessing Nuclear Crisis Escalation Risk (ROMANCER) is an agent-based simulation framework designed to explore the intersections between perception, cognition, and decisionmaking processes that could lead to the use of nuclear weapons.
ROMANCER is implemented as a suite of interconnected Python modules and tools, developed to enhance the understanding of nuclear escalation risk and to provide a structured and repeatable framework for analyzing decisionmaking processes in high-stakes situations. ROMANCER serves to aid U.S. planning and decisionmaking. It is not designed to predict the responses of specific leaders or the outcomes of specific scenarios.
This user guide serves as a companion to the ROMANCER codebase and is structured to provide a comprehensive understanding of ROMANCER, from initial setup to advanced use and development.
The research was sponsored by Air Force Global Strike Command (AFGSC) A5/8 and conducted by the Strategy and Doctrine Program within RAND Project AIR FORCE.
This publication is part of the RAND tool series. RAND tools include models, databases, calculators, computer code, GIS mapping tools, practitioner guidelines, web applications, and various other toolkits and applied research products. All RAND tools undergo rigorous peer review to ensure both high data standards and appropriate methodology in keeping with RAND's commitment to quality and objectivity.
This document and trademark(s) contained herein are protected by law. This representation of RAND intellectual property is provided for noncommercial use only. Unauthorized posting of this publication online is prohibited; linking directly to this product page is encouraged. Permission is required from RAND to reproduce, or reuse in another form, any of its research documents for commercial purposes. For information on reprint and reuse permissions, please visit www.rand.org/pubs/permissions.
RAND is a nonprofit institution that helps improve policy and decisionmaking through research and analysis. RAND's publications do not necessarily reflect the opinions of its research clients and sponsors.