Skip to content

christian-johnson/borsuk-ulam

Repository files navigation

Real-time Borsuk-Ulam visualizer

Screenshot 2025-12-21 at 9 22 23 AM

This repo provides the source code for a web app that visualizes the global temperature and barometric pressures, and finds points that lie exactly opposite each other on the globe and have identical temperatures and pressures. At least one pair of points are guaranteed to exist due to the Borsuk-Ulam theorem.

You can learn more about the "why" behind this app here.

The code does the following things:

  • Fetches global weather model data directly from the official GFS server.
  • Paints a map of temperature and pressure onto a Javascript globe (using globe.gl).
  • Searches the data to find Borsuk-Ulam compatible points, and plots those on top of the globe.
  • Uses Pyodide, so all the requests and computation happen in your browser, rather than on a server.

Running locally

Follow the following steps:

  1. Clone this repo: git clone git@github.com:christian-johnson/borsuk-ulam.git
  2. Change into the directory: cd borsuk-ulam
  3. Install dependencies: npm install
  4. Build the application: npm run dev
  5. Serve the page with the web server of your choice, e.g. npm run preview
  6. Visit the appropriate address in your browser (in this case, it would be localhost:4173).
  7. Wait for the Python kernel to load, click the button, and enjoy!

Contributing

Bug fixes & PRs are more than welcome!

About

A real-time Borsuk-Ulam theorem visualizer

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors