Skip to content

LALPulsar: add function for plotting mismatch ellipses

Karl Wette requested to merge ANU-CGA/lalsuite:metric-utils-py into master

Description

It's often useful when working with metric-based template banks to plot the mismatch ellipse: the set of points \vec x such that \vec x \cdot \mathbf{g} \cdot \vec x = \mu_{\textrm{max}}. When this ellipse is highly elongated, however, plotting isn't entirely trivial. Polar plotting in (r, \theta) with uniformly-spaced \theta tends not to work well, as shown in this example with \mathbf{g} = ( 10^8, 10^3 ; 10^3, 1 ):

mismatch_ellipse.png

I wrote a function a while ago that plots metric ellipses with adaptive spacing in \theta. It's a useful function to have around somewhere. This MR add it to a lalpulsar.metric_utils Python module in LALPulsar.

API Changes and Justification

Backwards Compatible Changes

  • This change does not modify any class/function/struct/type definitions in a public C header file or any Python class/function definitions
  • This change adds new classes/functions/structs/types to a public C header file or Python module

Backwards Incompatible Changes

  • This change modifies an existing class/function/struct/type definition in a public C header file or Python module
  • This change removes an existing class/function/struct/type from a public C header file or Python module

Review Status

n/a

Merge request reports