ConteXtuAlity: an open source Python package for contextuality

In the strange and counterintuitive world of quantum physics, there is a phenomenon known as contextuality. To understand it, imagine trying to describe a landscape where the color of a tree changes depending on which other trees you are looking at alongside it. In our everyday experience, an object has fixed properties; a red ball is red whether you are alone with it or in a crowd. But in the quantum realm, the answer to a question about a system can depend entirely on the other questions being asked at the same time. This is not a flaw in our measuring tools, but a fundamental feature of nature. Scientists have long sought to quantify exactly how much a system behaves this way, distinguishing between the predictable, classical world and the context-dependent quantum world. Doing so requires complex mathematics and the ability to simulate countless scenarios, a task that has traditionally been difficult and inaccessible to all but a handful of specialists.

A new open-source software package called ConteXtuΛlity, developed by Kim Vallée at Sorbonne Université, aims to bring these powerful calculations to a wider audience. This tool is designed to help researchers and students alike explore the boundaries of quantum theory by automating the heavy lifting of mathematical optimization. Instead of building complex equations from scratch for every new experiment, users can now define a scenario of measurements and outcomes, and the software will instantly calculate specific values that reveal how "contextual" the system is. The package focuses on two main numbers: the contextual fraction, which measures how much of a system's behavior cannot be explained by classical logic, and the signalling fraction, which measures how much information seems to leak between different parts of the experiment. By making these calculations accessible, the software allows scientists to test new hypotheses and analyze real-world experimental data with unprecedented ease.

The core of the package revolves around two main concepts: the measurement scenario and the empirical model. A measurement scenario is simply a map of what can be measured and how those measurements are grouped together. For instance, in a famous setup known as the KCBS scenario, there are five different measurements that can be paired up in specific ways. The software allows a user to define these groupings using simple lists of names or numbers. Once the map is drawn, the empirical model fills in the data. This is the collection of actual results or probabilities observed in an experiment. The software can accept data from real-world experiments, such as those conducted by Lapkiewicz and colleagues or Wang and colleagues, or it can generate theoretical models based on quantum states.

What makes this tool particularly powerful is its ability to handle the messy reality of experimental data. In the real world, measurements are rarely perfect. Sometimes, the same physical device used to measure a property in one context behaves slightly differently when used in another context. The software can account for these subtle differences. For example, when analyzing data from the Lapkiewicz experiment, the researcher used the package to show that if they treated two seemingly identical measurements as distinct because of how they were implemented, the calculated "contextual" nature of the system dropped significantly. This demonstrates that the software is not just a calculator, but a flexible instrument that can adapt to the specific constraints and quirks of different experimental setups.

The developer also used the package to create visual maps of how these quantum properties behave. By mixing different theoretical models together, they generated a heat map for the famous Bell-CHSH scenario, a standard test for quantum weirdness. This visual representation showed how the contextual fraction and the signalling fraction change as one moves from perfectly classical behavior to the most extreme quantum possibilities. The results confirmed that the software could quickly and accurately navigate this landscape, producing heat maps that help researchers visualize the boundaries between what is possible in classical physics and what is possible in quantum physics.

Beyond analyzing existing data, the package is designed to be a playground for new ideas. The author showed how a user could create a custom version of a measurement scenario by adding a simple rule, such as forbidding two measurements from both being "on" at the same time. When they applied this artificial constraint, the software instantly recalculated the results, showing that the system appeared to be fully contextual under the new rules. This flexibility suggests that the tool can be used to explore alternative theories of reality, not just the standard quantum model. It allows scientists to ask "what if" questions about the fundamental rules of the universe and see the mathematical consequences immediately.

To ensure the tool is reliable, the author ran a series of performance tests. They measured how long the software took to solve problems as the size of the scenarios grew larger. They found that while the time required to solve these problems increases rapidly as the scenarios get bigger, the software remains fast enough to handle reasonably complex situations. The tests were run using different mathematical solvers, confirming that the results are robust regardless of the underlying engine used to crunch the numbers. This benchmarking gives users confidence that the tool can handle the scale of problems they are likely to encounter in their research.

The package is built to be open and extensible, inviting the scientific community to contribute and expand its capabilities. While it currently focuses on a specific mathematical framework known as the sheaf-theoretic approach, the author plans to add support for other ways of understanding contextuality in the future. By providing a common language and a shared set of tools, ConteXtuΛlity aims to lower the barrier to entry for studying these profound questions. It transforms a field that often requires deep expertise in abstract mathematics into one where the focus can return to the physics itself, allowing researchers to spend less time coding and more time understanding the strange, context-dependent nature of our universe.