Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add eclipsing variable examples #46

Open
wants to merge 1 commit into
base: main
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 4 additions & 0 deletions config.defaults.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -105,3 +105,7 @@ docs:
srv:
coordinates: [330.302266, 66.153712]
title: Semi Regular Variable
eclipsing:
coordinates: [13.572527, 8.874651]
period: 1.739625
title: Eclipsing variable
100 changes: 100 additions & 0 deletions data/golden/eclipsing.csv
Original file line number Diff line number Diff line change
@@ -0,0 +1,100 @@
274.146463,-11.304450
299.123212,22.256431
299.937024,36.814352
287.900210,12.052041
272.476947,8.065136
290.223264,22.898495
297.565665,36.039720
299.394481,12.683093
287.814253,1.040708
291.524111,21.124597
312.714137,33.676498
62.164659,52.399149
295.240507,38.108905
285.846845,-6.103430
294.619528,34.983123
298.554180,17.973026
325.951714,46.814714
297.496568,27.683638
331.906743,52.762615
283.987243,-2.104873
293.916020,23.191226
289.935838,24.505788
294.872445,27.314646
335.163847,48.169566
72.920711,54.668397
332.418060,50.449305
94.665614,21.043275
293.648889,14.307628
44.026125,63.856213
300.008086,36.311764
271.770552,3.299863
285.124653,13.537304
330.564459,49.332061
317.917853,46.636967
295.925777,29.422887
296.875210,48.483398
290.851681,23.131892
276.961671,-6.238794
294.877270,18.282953
285.000444,16.456491
95.387552,18.200595
293.389604,16.613031
287.477976,-2.279015
294.638968,13.291402
286.630881,2.389807
296.002730,47.411598
23.999596,57.215157
287.920100,-1.730727
297.095942,16.051791
311.409500,36.020147
286.776135,0.599607
286.388330,-3.110564
294.287901,23.528234
286.447203,36.109189
277.089832,-8.190509
297.750232,17.243874
303.543340,17.510479
295.265102,16.537755
297.349782,19.324243
296.611745,32.744883
275.093695,17.921072
296.944836,30.618820
299.908811,40.651812
23.023140,52.201994
292.834122,20.521963
293.550161,47.587135
285.120962,-2.202684
294.633675,24.850993
19.831804,60.073749
289.843487,14.753683
294.849534,25.563400
293.757945,14.457332
316.743447,56.059025
283.909221,40.982551
301.455248,35.386098
283.304396,10.992555
273.264710,-5.679077
300.852949,22.434963
296.056701,40.678053
285.387382,-6.251603
262.801902,3.530161
290.121515,24.825112
290.895606,23.868921
306.978154,14.255226
286.724912,19.212971
275.422753,-14.404162
295.240086,30.741167
283.024534,-13.033560
337.108420,49.349435
310.263868,30.108541
285.343810,11.409299
13.572527,8.874651
321.378594,44.533548
293.192381,-7.433488
295.486916,37.054133
292.021086,0.698696
292.817703,19.223730
294.725792,15.377641
295.466481,31.984389
293.945801,28.674912
32 changes: 32 additions & 0 deletions doc/field_guide__eclipsing.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,32 @@
## Eclipsing variables (ecl)

Eclipsing variables are binary stars systems in which the orbital plane lies nearly in the line of sight of the observer. The binary components pass in front of one another from observer's perspective and so their combined brightness decreases periodically.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

binary stars systems -> binary star systems
from observer's perspective -> from the observer's perspective


Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe say something here briefly about the eclipses can be different shapes and depths, which you get to below?

### Classification and numbers
- Supertypes
- variable
- periodic
- Subtypes
- EA
- EB
- EW
- Occurrence rate: very common, about 10<sup>6</sup> expected in ZTF data

### ZTF light curves
![ZTF eclipsing](data/eclipsing.png)

#### Description
Eclipsing variables show regular, periodic "V-shape" dips in their phase folded light curves, which may be sharp or rounded, depending on the system. Their periods may range from minutes to years. Eclipse amplitudes vary from ~0.1 to several magnitudes.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is it just survey sensitivity that prevents us from going below ~0.1? Maybe we explicitly call that out as for ZTF then.


#### Light curve characteristics
- periodic variable
- Range of amplitudes (~0.1 to >1 mag)
- Periods (from minutes to years)

![HR diagram of eclipsing variables](data/hr__eclipsing.png)

![Period histogram of eclipsing variables](data/period__eclipsing.png)

### References and further reading:
- Graczyk et al. (2011) <a href="https://ui.adsabs.harvard.edu/abs/2011AcA....61..103G/abstract">The Optical Gravitational Lensing Experiment. The OGLE-III Catalog of Variable Stars. XII. Eclipsing Binary Stars in the Large Magellanic Cloud</a>
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We were writing out the whole citation I think, i.e. including journal and so on.

- Soszynski et al. (2015) <a href="https://ui.adsabs.harvard.edu/abs/2016AcA....66..405S/abstract">The OGLE Collection of Variable Stars. Over 450 000 Eclipsing and Ellipsoidal Binary Systems Toward the Galactic Bulge</a>