Loading [MathJax]/extensions/TeX/AMSsymbols.js
LALPulsar 7.1.1.1-b246709
All Data Structures Namespaces Files Functions Variables Typedefs Enumerations Enumerator Macros Modules Pages
PtoleMetricTest.c File Reference

Tests the LALPtoleMetric() function. More...

Detailed Description

Tests the LALPtoleMetric() function.

Author
Owen, B. J., Jones, D. I.

Program PtoleMetricTest

Usage

PtoleMetricTest

Description

This program computes metric components using LALPtoleMetric(). The ordering of the components is \( (f_0, \alpha, \delta, f_1, \ldots) \) for the unprojected metric, and \( (\alpha, \delta, f_1, \ldots) \) for the metric with \( f_0 \) projected out.

With no options, this program displays metric components for a single point in parameter space for the default integration time (see the -t option).

The -b option sets the beginning time of integration to the option argument. (Default is \( 0 \) seconds)

The -e option causes the program to showcase error messages when given bad parameter values, etc.

The -m option sets the mismatch (default is \( 0.02 \) ).

The -p option is provided for users who wish to view the power mismatch contours provided by the -x option (see below) but don't have xmgrace installed. All necessary data is simply written to a file `‘nongrace.data’'; it's probably best to look at the code to see the exact format. The user should then write a small script to convert the data into the format appropriate to their favorite graphics package.

The -t option sets the duration of integration in seconds. The default is \( 10^5 \) seconds, which is chosen because it is about one day but not an integer multiple of any astronomically important timescale.

The -x option produces a graph of the 2% power mismatch contours on the sky. Dimensions of the ellipses have been exaggerated by a factor of MAGNIFY (specified within the code) for legibility. The purpose of the graph is to get a feel for how ellipses are varying across parameter space. Note that this option makes a system call to the xmgrace program, and will not work if that program is not installed on your system.

Algorithm

Uses

xmgrace
void LALCheckMemoryLeaks(void)
#define lalDebugLevel
void LALPtoleMetric(LALStatus *status, REAL8Vector *metric, PtoleMetricIn *input)
Computes metric components for a pulsar search in the `‘Ptolemaic’' approximation; both the Earth's s...
Definition: PtoleMetric.c:91
void LALProjectMetric(LALStatus *stat, REAL8Vector *metric, BOOLEAN errors)
Project out the zeroth dimension of a metric.
Definition: PtoleMetric.c:732
void LALDestroyVector(LALStatus *, REAL4Vector **)
void LALDCreateVector(LALStatus *, REAL8Vector **, UINT4)
void LALDDestroyVector(LALStatus *, REAL8Vector **)
void LALCreateVector(LALStatus *, REAL4Vector **, UINT4)

Notes

The graph shows that the patches' overall area is independent of right ascension but that those near the equator rotate, which adds a new complication to the tiling.

Definition in file PtoleMetricTest.c.

Go to the source code of this file.

Macros

Error Codes
#define PTOLEMETRICTESTC_EMEM   1
 
#define PTOLEMETRICTESTC_ESUB   2
 
#define PTOLEMETRICTESTC_ESYS   3
 
#define PTOLEMETRICTESTC_MSGEMEM   "memory (de)allocation error"
 
#define PTOLEMETRICTESTC_MSGESUB   "subroutine failed"
 
#define PTOLEMETRICTESTC_MSGESYS   "system call failed"
 

Macro Definition Documentation

◆ PTOLEMETRICTESTC_EMEM

#define PTOLEMETRICTESTC_EMEM   1

Definition at line 100 of file PtoleMetricTest.c.

◆ PTOLEMETRICTESTC_ESUB

#define PTOLEMETRICTESTC_ESUB   2

Definition at line 101 of file PtoleMetricTest.c.

◆ PTOLEMETRICTESTC_ESYS

#define PTOLEMETRICTESTC_ESYS   3

Definition at line 102 of file PtoleMetricTest.c.

◆ PTOLEMETRICTESTC_MSGEMEM

#define PTOLEMETRICTESTC_MSGEMEM   "memory (de)allocation error"

Definition at line 104 of file PtoleMetricTest.c.

◆ PTOLEMETRICTESTC_MSGESUB

#define PTOLEMETRICTESTC_MSGESUB   "subroutine failed"

Definition at line 105 of file PtoleMetricTest.c.

◆ PTOLEMETRICTESTC_MSGESYS

#define PTOLEMETRICTESTC_MSGESYS   "system call failed"

Definition at line 106 of file PtoleMetricTest.c.