`curve()`#

curvit.curve(events_list='', xp=None, yp=None, radius=6, bwidth=50, framecount_per_sec=28.7185, background=None, sky_radius=12, x_bg=None, y_bg=None, aperture_correction=None, saturation_correction=False, ZEF_correction_factor=1, whole_figure_resolution=256, sub_fig_size=40, fontsize=9)#

Create light curve for a source.

Parameters:

events_list (file path) – The name of the events list FITS file.
xp (float) – The X-coordinate of the source.
yp (float) – The Y-coordinate of the source.
radius (float, optional) – The source aperture radius in pixels. This parameter has a default value of 6.
bwidth (float, optional) – Time bin width in seconds. the default value is 50.
framecount_per_sec (float, optional) –
The framerate of the observation, with a default value of 28.7185 frames per second for 512 x 512 window mode. The most accurate way to get the framerate would be to take the value of (1 / INT_TIME). INT_TIME value can be found from the corresponding image header. Approximate values of framerate for different window modes of UVIT are given in the table below.

window mode

frames per second

512 x 512

28.7

350 x 350

61

300 x 300

82

250 x 250

115

200 x 200

180

150 x 150

300

100 x 100

640
background ({'auto', 'manual', None}, optional) –
The parameter affects how the background count-rate estimation is done.
- 'auto': Automatic estimation of the background count-rate.
- 'manual': To manually specify a background region using x_bg and y_bg parameters.
- None: No background estimation is carried out. This is the default method.
sky_radius (float, optional) – The background aperture radius in pixels. The default value is 12.
x_bg (float, optional) – The X-coordinate of the background region.
y_bg (float, optional) – The Y-coordinate of the background region.
aperture_correction ({'fuv', 'nuv', None}, optional) –
The parameter affects how the aperture correction is done.
- 'fuv': Aperture correction for the FUV channel is applied.
- 'nuv': Aperture correction for the NUV channel is applied.
- None: No aperture correction is applied. This is the default method.
saturation_correction (bool, optional) – If True, saturation correction is applied. The default value is False. Note that aperture correction should be applied if you apply saturation correction.
ZEF_correction_factor (float, optional) – To apply the correction for zero event frames. The default value is 1 (no correction).

window mode	frames per second
512 x 512	28.7
350 x 350	61
300 x 300	82
250 x 250	115
200 x 200	180
150 x 150	300
100 x 100	640

Note

It is essential to set the correct value of the framerate. Most UVIT observations are carried out in 512 x 512 window mode.

Example

>>> import curvit
>>> curvit.curve(events_list = 'AS1G06_084T01_9000000710uvtFIIPC00F1_l2ce.fits.gz',
...              xp = 2636.71, yp = 907.91,
...              radius = 15,
...              bwidth = 50,
...              background = 'auto')

Background CPS (scaled to aperture area): 0.02155 ± 0.00425

-------------------------- curve --------------------------
source: source_2636.71_907.91_AS1G06_084T01_9000000710uvtFIIPC00F1_l2ce.png
        source_zoomed_2636.71_907.91_AS1G06_084T01_9000000710uvtFIIPC00F1_l2ce.png
data: curve_2636.71_907.91_AS1G06_084T01_9000000710uvtFIIPC00F1_l2ce.dat
plot: curve_2636.71_907.91_AS1G06_084T01_9000000710uvtFIIPC00F1_l2ce.png

Done!

curve()#

`curve()`#