SSOXmatch

Available resources for SSOXmatch

User manual (complements the paper by T. Alonso-Albi 2025)

Executable jar file for SSOXmatch 0.7. Please note that Java 21 is required to run this jar file, check your version with the command java -version. The code has been obfuscated, and the jar is only provided for testing purposes. The source code is copyrighted by Tomás Alonso Albi (2021-2025). For reference see the paper by T. Alonso Albi (2025). To access the basic help of the program execute the command java -jar SSOXmatch.jar. The user manual above can be useful, although it can also be accessed from the command-line.

Version 0.7 of the jar file, published on November 12, 2025. Main changes (more details in the user manual):

- Support for cross-matches of space telescopes, for instance the track of JWST appearing in an Euclid observation, or the opposite

- Solved a memory/lock problem when computing cross-matches of bodies very close to the telescope

- Cross-matches exported to binary files, and then ingested in groups of 100 000, to avoid memory issues when holding millions of them in memory. This allows the program to run indefinitely

- The pre-integration of new bodies suffering close encounters with other massive bodies can now be updated from the console (see documentation)

Version 0.6 of the jar file published on October, 12, 2025. Main changes (more details in the user manual):

- Fixed a bug that may produce XMs for some comets with an SSO identifier inconsistent with the sso_id table. This bug is only relevant when using postgres databases

- Important performance optimizations that were lost in some of the latest code commits from late 2024

- Data (orbital elements, observation lists) updated to October, 11, 2025

Cross-match service

A basic web service is provided below to return pre-computed cross-matches for any of the supported surveys in the paper (JWST, HST, XMM, Herschel, Spitzer, Euclid), providing an observation identifier or a body name (asteroid, comet, spacecraft, planet or moon). Examples would be 'jw01245041001_03102_00001_nrcblong' for a cross-match of Didymos in JWST, 'Shoemaker-Levy 9' for the cross-matches of this comet, that impacted Jupiter, or 'XMM' for cross-matches of the XMM spacecraft (in HST images). The number of queries allowed is limited to 10/minute. All cross-matches were computed for a list of observations and bodies updated to October 11, 2025, using SSOXmatch 0.7, later updated incrementally to December 13, using version 0.8. Elements used are those provided by the JPL (for both asteroids and comets), and Lowell+cometpro. The field jpl_elem identifies which set of elements where used to compute a given cross-match: true for JPL elements, and false for the other set. When the cross-match is detected with both sets of elements, it will appear duplicated, with only minor differences in the predicted positions. No guarrantee is provided about the availability of the service.

Observation identifier / source name: