PRINCESS: Prediction of compact binaries observations with gravitational waves

We present PRINCESS, a computational tool designed to predict gravitational wave observations from compact binary coalescences (CBCs) in current and future detector networks. PRINCESS uniquely combines predictions of both individual gravitational wave events and the associated astrophysical background, leveraging user-provided CBC catalogs. With the anticipated improvements in detector sensitivity from second-generation (2G) to third-generation (3G) observatories like the Einstein Telescope and Cosmic Explorer, the tool aims to constrain models of stellar formation and compact object evolution. PRINCESS calculates the signal-to-noise ratio (SNR) for individual events and predicts the stochastic background arising from unresolved sources. We detail the code structure, installation, and usage, providing examples of predictions for different astrophysical models and detector configurations. Results include forecasts for binary black hole detections and background spectra, highlighting the potential of future networks to resolve nearly all CBC events. We also discuss ongoing developments to expand PRINCESS's capabilities, including accounting for additional sources such as extreme mass ratio inspirals (EMRIs) and incorporating more advanced detector models.