{"id":15720830,"url":"https://github.com/chimari/hskymon","last_synced_at":"2025-05-13T02:49:27.329Z","repository":{"id":77801621,"uuid":"75891092","full_name":"chimari/hskymon","owner":"chimari","description":"Sky Monitor for Subaru Telescope","archived":false,"fork":false,"pushed_at":"2023-08-25T12:02:46.000Z","size":38932,"stargazers_count":4,"open_issues_count":2,"forks_count":2,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-04-01T06:02:44.877Z","etag":null,"topics":["astronomy","c","gtk2","gtk3","observatory","subaru","telescope"],"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/chimari.png","metadata":{"files":{"readme":"README","changelog":"ChangeLog","contributing":null,"funding":null,"license":"COPYING","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":"AUTHORS","dei":null,"publiccode":null,"codemeta":null}},"created_at":"2016-12-08T01:30:42.000Z","updated_at":"2024-02-27T05:26:22.000Z","dependencies_parsed_at":"2024-10-03T22:00:39.294Z","dependency_job_id":"2892cc19-5869-40d2-9534-752deb336130","html_url":"https://github.com/chimari/hskymon","commit_stats":{"total_commits":391,"total_committers":2,"mean_commits":195.5,"dds":0.002557544757033292,"last_synced_commit":"d7ae9d8282059d6c971a215d479fc14dd89268c1"},"previous_names":[],"tags_count":9,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chimari%2Fhskymon","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chimari%2Fhskymon/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chimari%2Fhskymon/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chimari%2Fhskymon/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/chimari","download_url":"https://codeload.github.com/chimari/hskymon/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253862736,"owners_count":21975583,"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","c","gtk2","gtk3","observatory","subaru","telescope"],"created_at":"2024-10-03T22:00:28.739Z","updated_at":"2025-05-13T02:49:27.306Z","avatar_url":"https://github.com/chimari.png","language":"C","funding_links":[],"categories":[],"sub_categories":[],"readme":"#########################################################################\n#   Sky Monitor for Subaru Telescope  (hskymon)\n#                         Document file\n#\n#\n#                                  ver 4.5.7    2023/08/25\n#                               Copyright (C) 2003-23 Akito Tajitsu\n#                                        akito.tajitsu_at_nao.ac.jp\n#      Subaru Telescope, National Astronomical Observatory of Japan\n#########################################################################\n\n\n*** Introduction\nThis program (hskymon) is a GTK+2/3 based telescope monitoring \napplication for SUBARU Telescope, National Astronomical Observatory\nof Japan.\nIt can be useful for actual observation and also for obs preparation \nas a telescope simulator.\nBasically, hskymon is optimized for Subaru Telescope. However,\nit can be adopted to other telescopes, changing positional parameters.\n\nFor target lists to display on the program, you can input OPE\nfiles for SOSs or CSV text lists.\n\nThe latest version (source code and Win/Mac binary packages) can be \nfound  in the official page of NAOJ,\n  https://www.naoj.org/Observing/tools/hskymon/\nor in in GitHub,\n  https://github.com/chimari/hskymon/\n.\nIf you want to make a clone of the latest source code via GitHub, use\n  git clone https://github.com/chimari/hskymon.git\nin your terminal.\n\n*** Environment\nhskymon requires UNIX operating system with X window system,\nMicrosoft Windows (7 or later), or mac OS (Mavericks or later).\n\nTo compile this program from its source code, you need to install\nGtk+ development tools (for Windows, the maintainer is using msys2).\nEither Gtk+2 (\u003e2.24; default) or Gtk+3 (\u003e3.22) is required.\nlibxml2, openssl, and json-c are also required to build the program.\n\nIn order to get telescope status, hskymon requires xmlrpc-c library.\nBut, Windows/Mac version does not support this function.\nYou need to install some libraries and developer's environment for them\nto make this program.\n(gtk+2-dev, xmlrpc-c3-dev, libcurl4-openssl-dev ... etc.)\n\nIf you are using an internet security software (ESET etc.), you may\nhave problems on HTTP/HTTPS accesses on hskymon (stacks, slowness...).\nIn such cases, please try to add\n  C:\\Program Files\\Subaru Telescope\\hskymon\\hskymon.exe  (Win)\n  /Applications/hskymon.app/Contents/MacOS/hskymon-bin   (mac)\nto the exclusion list in your security software.\n\n\n*** Build from the source code\n  - Extract the source archive and enter to the extracted directory.\n\n  - (only when you cloned the source tree by git)\n    % touch configure configure.ac aclocal.m4 Makefile.am Makefile.in\n\n  - % ./configure\n      [option]\n        --with-gtk3   : use Gtk+3 instead of Gtk+2\n        --with-xmlrpc : make w/xmlrpc to get telescope status in Gen2\n        --with-win32  : make for Windows (32bit/64bit)\n        --with-gtkmac : make w/gtk-mac-integration for mac OS\n        --with-maintain : designate deprecated functions (for maintainer)\n\n    If you failed in configure (possiblly aclocal error),\n    Please try\n           % /autogen.sh\n    before your configure session.\n\n  - % make\n    Then, an executable file \"hskymon\" will be created.\n\n  - # make install  \n    (or you can copy \"hskymon\" file to an appropriate directory.)\n\n\n*** Command line option\n     -h, --help                    : Print help message\n     -i, --input [input-file]      : Set the input CSV list file\n     -a, --with-allsky             : Switch on All Sky Camera\n     -nt, --without-telstat        : Switch off to read Telescope Status\n     -s, --server [server-address] : Override Telstat Server\n     -l, --log [log-file]          : Output log file\n\n\n*** XMLRPC\nIf you compiled hskymon with \"xmlrpc\" option, hskymon can get the current\ntelescope status from Subaru Gen2 server (effective only in the Subaru\nsummit network.)\nIn this case, you should set the address of Gen2 status server\n [1] by a commandline option \"-s\" (or \"--server\")\n       % hskymon -s status.server.address.foo.bar\nor\n [2] by an environment variable  \"GEN2_RO_SERVER\"\n. The environment variable [2] yields to the command line option [1].\nIf either [1] or [2] is found in the start up, hskymon aborts to communicate\nwith the status server.\n\n\n*** Input files\n[1]OPE file\nOPE files for SOSs can be available for objects inputs.\nhskymon reads the parameter list section in OPE files likely,\n\n   \u003cPARAMETER_LIST\u003e\n\n   TGT_BD44493=OBJECT=\"BD+44 493\" RA=022649.60 DEC=+445746.80 EQUINOX=2000.00\n   TGT_HD222304=OBJECT=\"HD222304\" RA=033908.30 DEC=+502818.20 EQUINOX=2000.00\n   TGT_HD224544=OBJECT=\"HD224544\" RA=235849.20 DEC=+322254.10 EQUINOX=2000.00\n   TGT_HD225132=OBJECT=\"HD225132\" RA=000344.40 DEC=-172009.50 EQUINOX=2000.00\n           ....................................\n\nAll characters in the objectname will be capitalized.\n\n.prm files in which standard stars are defined are also loaded\nautomatically.\nYou should write command to load *.prm files likely\n\n*LOAD \"hogehoge.prm\"\n\nin the \u003cPARAMETER\u003e field of OPE files.\n# double quotation is required for the file name.\nCurrent searching paths for *.prm files are\n  1.  same directory with the loaded *.ope\n  2.  subdirectory \"COMMON/\"\n  3.  same level directory \"../COMMON/\"\n  4.  \"~/Procedure/\"\n  5.  \"~/Procedure/\u003cINST\u003e/\"\n  6.  \"~/Procedure/\u003cINST\u003e/COMMON/\"\n  7.  \"~/Procedure/COMMON/\"\n\n\nAs default, hskymon displays all objects defined in the loaded OPE file.\nIf you want to hide unused objects (in \"GetObject*\", \"GetStandard*\" or \n\"SetupField*\" commands in \u003cCOMMAND\u003e field of the OPE file),\nyou can hide them with \"Hide Objects unused in OPE file\" button\n(the 2nd button in ASC/Telstat menu). \n\nFor .prm files, the objects are loaded only in the case that it is used\nin commands (\"GetObject*\", \"GetStandard*\" or \"SetupField*\") in the OPE\nfile.\n\n\n[2]CSV Text file\nThe text files written in the following CSV format are also available for\nobjects inputs.\n\n\tHD94028     ,105128.1 ,+201639.0 ,2000,  \u003ccomments\u003e\n\tBD+36 2165  ,111248.0 ,+354343.9 ,2000,  Mv=8.4  Fe/H=-2\n\tHD97916     ,111554.2 ,+020512.1 ,2000,  Mv=10.2 Fe/H=-2\n\tBD+51 1696  ,114635.2 ,+505254.7 ,2000   \n\tBD-13 3442  ,114650.7 ,-140643.5 ,2000,\n           ....................................\n\n\n[3] Non-Sidereal Tracking File (TSC format)\nNon-Sidereal tracking files for TSC can also be avairable.\nPlease put TSC files in an appropriate directory (maybe in the same \ndirectory where your OPE files locate) and load them from the menu.\nFiles must follow the format described in\n  https://www.naoj.org/Observing/Telescope/Tracking/NonSidereal/\n. You should use \"Geocentric\" coordinate in TSC files.\nThey would be automatically converted into topocentric in the program.\nWhen hskymon's time and date are out of the range of the tracking \ncalculation, the object will be plotted with an \"x\" mark in the monitor.\nYou can check the orbit of the non-sidereal target in the Finsing Chart.\n\n\n[4] Non-Sidereal Tracking File (JPL HORIZONS format)\nhskymon can also load NASA JPL HIRIZONS output files.\n  https://ssd.jpl.nasa.gov/horizons.cgi\nPlease note that you should set \n   \"Epehmeris Type\" = OBSERVER\n   \"Observer Location\" = Geocentric\n   \"Table Settings\" = 1. Astrometric RA \u0026 Dec, 20. Observer range\nfor your input.\nEither calendar date or JD is acceptable for date format.\nFrom the main menu, HORIZONS files can be converted into the TSC format.\n\n\n*** Copyright\n   The code in this distribution is Copyright 2003-2018 by Akito Tajitsu.\n\n   This program is free software; you can redistribute it and/or modify\n   it under the terms of the GNU General Public License as published by\n   the Free Software Foundation; either version 3, or (at your option)\n   any later version.\n\n   This program is distributed in the hope that it will be useful,\n   but WITHOUT ANY WARRANTY; without even the implied warranty of\n   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the\n   GNU General Public License for more details.\n\n   You should have received a copy of the GNU General Public License\n   along with this program; if not, write to the Free Software\n   Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA\n\n   In addition, as a special exception, A.Tajitsu gives permission to link \n   this code of this program with the OpenSSL library (or with modified\n   versions of OpenSSL that use the same license as OpenSSL), and distribute\n   linked combinations including the two. You must obey the GNU General \n   Public License in all respects for all of the code used other than OpenSSL.\n   If you modify this file, you may extend this exception to your version of \n   the file, but you are not obligated to do so. If you do not wish to do so,\n   delete this exception statement from your version.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchimari%2Fhskymon","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fchimari%2Fhskymon","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchimari%2Fhskymon/lists"}