{"id":18412258,"url":"https://github.com/bashrc2/waspscan","last_synced_at":"2025-04-12T23:45:53.926Z","repository":{"id":109424060,"uuid":"412561553","full_name":"bashrc2/waspscan","owner":"bashrc2","description":"Utility for detecting exoplanet transits within SuperWASP logs","archived":false,"fork":false,"pushed_at":"2021-10-07T09:38:48.000Z","size":5529,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-12T23:45:51.647Z","etag":null,"topics":["astronomy","exoplanets","light-curve-models","transit","transiting-exoplanets"],"latest_commit_sha":null,"homepage":"","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bashrc2.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2021-10-01T17:34:13.000Z","updated_at":"2021-10-07T09:38:50.000Z","dependencies_parsed_at":null,"dependency_job_id":"d5d8eca1-9fd6-4a38-93f7-52d71c529b33","html_url":"https://github.com/bashrc2/waspscan","commit_stats":{"total_commits":40,"total_committers":2,"mean_commits":20.0,"dds":"0.025000000000000022","last_synced_commit":"ddeef7311a910cb8a90a57594ca4bfcf77a6d887"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bashrc2%2Fwaspscan","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bashrc2%2Fwaspscan/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bashrc2%2Fwaspscan/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bashrc2%2Fwaspscan/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bashrc2","download_url":"https://codeload.github.com/bashrc2/waspscan/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248647258,"owners_count":21139081,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["astronomy","exoplanets","light-curve-models","transit","transiting-exoplanets"],"created_at":"2024-11-06T03:40:34.844Z","updated_at":"2025-04-12T23:45:53.901Z","avatar_url":"https://github.com/bashrc2.png","language":"C","funding_links":[],"categories":[],"sub_categories":[],"readme":"WASPscan\n========\n![Example light curve J233415](images/J233415.png)\n\nThis utility takes log files produced by SuperWASP and searches for exoplanet transits within them, producing plots if any are found. A range of possible orbital periods can be given, or if the period is already known then that can be specified.\n\nFor more information see:\n\n    https://en.wikipedia.org/wiki/SuperWASP\n    http://wasp-planets.net\n\nInstallation\n------------\nInstallation is pretty conventional:\n\n    sudo apt-get install build-essential gnuplot python3-astropy\n    make\n    sudo make install\n\nYou will also need to obtain the SuperWASP log files. These can be ontained from:\n\n    http://exoplanetarchive.ipac.caltech.edu/docs/SuperWASPBulkDownload.html\n\nThere are a couple of scripts which contain many *wget* commands which download individual observation series for particular stars. For the currently known exoplanets:\n\n    mkdir data\n    cd data\n    wget http://exoplanetarchive.ipac.caltech.edu/data/ETSS/SuperWASP/metadata/SuperWASP_confirmed_wget.bat\n\nAnd for all the available data:\n\n    wget http://exoplanetarchive.ipac.caltech.edu/bulk_data_download/SuperWASP_wget.tar.gz\n    tar -xzvf SuperWASP_wget.tar.gz\n\nOnce you've downloaded those you can open *SuperWASP_confirmed_wget.bat* in your favourite editor and manually run individual wgets, or make it executable and download all the data sets. Please be warned that downloading all of the data series could take a very long time, so you may want to be selective.\n\nFile Formats\n------------\nThe two file formats used are *fits* and *tbl*. waspscan only uses the tbl format, so if you have fits files those can be converted with:\n\n    fits2tbl [fits filename] \u003e [table filename]\n\nOr for non-WASP fits files:\n\n    fits2tbl [fits filename] [table index] \u003e [table filename]\n\nWhere the table index is a number of the table inside of the fits file.\n\nUsage\n-----\nWithin data/SuperWASP_tile000042_wget.bat:\n\n    wget -O '1SWASP_J001905.33-441133.1_lc.tbl' 'http://exoplanetarchive.ipac.caltech.edu:80/data/ETSS//SuperWASP/TBL/DR1/tile000042/1SWASP_J001905.33-441133.1_lc.tbl' -a search_336789464.log\n\nTo search for a transit within a range of orbital periods:\n\n    waspscan -f 1SWASP_J001905.33-441133.1_lc.tbl --min 2.0 --max 2.1\n\nThe above will search a particular log file for orbits in the range 2.0 to 2.1 days. If a transit is found then it will be plotted as *png* files saved to the current directory.\n\n    \u003e 10554 values loaded\n    \u003e orbital_period_days 2.075600\n\nWe found one! We can view it with:\n\n    shotwell 1SWASP_J001905.33-441133.1_lc_distr.png\n\nBut it doesn't look quite right. We can manually tweak around with the orbital period to get the light curve as focussed as possible:\n\n    waspscan -f 1SWASP_J001905.33-441133.1_lc.tbl --period 2.07592\n    shotwell 1SWASP_J001905.33-441133.1_lc_distr.png\n\nAnd also increase the vertical scale a little:\n\n    waspscan -f 1SWASP_J001905.33-441133.1_lc.tbl --period 2.07592 --vscale 1.4\n    shotwell 1SWASP_J001905.33-441133.1_lc_distr.png\n\nIf you want to scan multiple *tbl* files or *fits* files within a directory there's also a helper script for that purpose:\n\n    waspscandir [minimum period] [maximum period]\n\nOther parameters can also be specified. See the --help option for details.\n\nLog files will be scanned one by one and if transits are found then plot images will be generated for them within the same directory for subsequent manual review.\n\nScaling up the search\n---------------------\nIt is also possible to install a daemon which will search through light curves and report its results.\n\n    sudo startwaspd --archive [bulk data download url]\n                    --start [percent] --end [percent]\n                    --min [period days] --max [period days]\n                    --minsamples [number]\n                    --email [email address]\n                    --store [path]\n                    --minfilesize [bytes]\n\nThe start and end percent values indicate where within the total data set the daemon will begin searching and where it will end. Hence you can distribute the search across multiple machines, each searching only a portion of the data. The --email parameter is optional and will only work if the machine has an email server installed. If an email address is set then when a candidate transit is detected a corresponding email will be sent. The --minsamples parameter can be used to set a lower bound on the number of samples (observations) in the data set. If this value is too low then there won't be enough data to have much confidence if a possible transit is found.\n\nThe *--store* option can be used to store all of the downloaded files to some particular directory. By default only data for candidate transits are stored and all other data is disguared. Storing the data may be useful if you have plenty of storage space and if you may want to do a second detection run over the same data. If you use this option then *--minfilesize* can also be used to set a minimum file size to store, otherwise many files containing only one or two samples will be stored, which are unlikely to be useful for any subsequent analysis.\n\nYou can check whether the daemon is running with:\n\n    systemctl status waspd\n\nor otherwise just:\n\n    ps aux | grep waspd\n\nAny candidate transits will be saved into the directory */home/wasp/candidates*\n\nTransits found so far\n---------------------\n\nJ191554.35+380338.2 and J001905.33-441133.1 are possible exotrojan systems.\n\nJ001128.53-443020.8 has a possible [opposition surge](https://en.wikipedia.org/wiki/Opposition_surge)\n\n| Series              | Period (days) | RA         | Dec        | Date       |\n|---------------------|---------------|------------|------------|------------|\n| J001905.33-441133.1 |  2.07592      |   4.772222 | -44.192553 | 2016-03-06 |\n| J001128.53-443020.8 |  0.95055      |   2.868903 | -44.505783 | 2016-03-06 |\n| J000948.40-442017.0 |  1.05621      |   2.451678 | -44.338056 | 2016-03-01 |\n| J191552.31+380252.2 |  1.69107      | 288.967958 |  38.047858 | 2016-01-15 |\n| J191554.35+380338.2 |  2.28720      | 288.976461 |  38.060628 | 2016-01-15 |\n| J191548.18+380236.2 |  1.69142      | 288.950786 |  38.043403 | 2016-01-03 |\n| J191549.90+380240.1 |  1.69104      | 288.957942 |  38.044497 | 2016-01-03 |\n| J191550.32+380251.1 |  1.68959      | 288.959689 |  38.047547 | 2016-01-03 |\n| J191443.55+391944.9 |  1.37791      | 288.681475 |  39.329156 | 2016-01-01 |\n| J191418.55+382730.6 |  1.31440      | 288.577297 |  38.458506 | 2015-12-31 |\n| J191412.95+382646.8 |  1.31615      | 288.553969 |  38.446347 | 2015-12-31 |\n| J192648.00+355855.8 |  1.55505      | 291.700039 |  35.982169 | 2015-12-26 |\n| J211848.09+533925.8 |  0.82627      | 319.700378 |  53.657186 | 2015-05-16 |\n| J211845.72+533944.0 |  0.82627      | 319.690506 |  53.662228 | 2015-05-16 |\n| J212231.01+522639.2 |  4.145        | 320.629211 |  52.444239 | 2015-05-16 |\n| J212234.52+485650.1 |  0.9347       | 320.643861 |  48.947272 | 2015-05-16 |\n| J211849.81+534028.4 |  0.825695     | 319.707581 |  53.674575 | 2015-05-16 |\n| J212145.92+510923.6 |  1.25202      | 320.441367 |  51.156575 | 2015-05-16 |\n| J211300.19+523120.0 |  1.87395      | 318.2508   |  52.52242  | 2015-05-10 |\n| J211324.40+533638.4 |  1.32870      | 318.351672 |  53.610672 | 2015-05-10 |\n| J211359.94+512655.7 |  0.849755     | 318.49975  |  51.448808 | 2015-05-10 |\n| J211401.27+512618.0 |  0.849905     | 318.505308 |  51.438358 | 2015-05-10 |\n| J213207.57+423029.3 |  1.05077      | 323.031581 |  42.508156 | 2015-05-10 |\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbashrc2%2Fwaspscan","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbashrc2%2Fwaspscan","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbashrc2%2Fwaspscan/lists"}