telescope

望遠鏡是一種開源Web應用程序，可使用Sun Grid Engine（SGE）按需調度系統跟踪提交給遠程服務器的作業進度。它允許遠程安排預定義的管道以及重新安排的排隊工作。此外，輸出文件是在HTML中實時渲染的，從而允許使用Markdown和Rich-Text功能。除了SSH連接外，望遠鏡不假設遠程服務器的任何內容。使用SSH鍵對構建連接，這些SSH鍵對加密後存儲。

有關更多信息，屏幕截圖和現場直播，請訪問我們的Wiki。

如果您有興趣了解有關望遠鏡的更多信息，或者您想加入團隊做出貢獻，請隨時與我們聯繫。有幾種貢獻方法！另外，請訪問Wiki的文檔部分，以了解軟件的更多描述，並詳細介紹瞭望遠鏡的安裝和運行。

該項目最初是從加州大學洛杉磯分校定量和計算生物學研究所（QCBIO）的合作社的努力開始的，並在冬季Python Hackathon期間開發。目前，來自QCBIO社區和其他各種實驗室的許多人正在開發它。我們還在研究描述該系統的論文，以及如何使用它來幫助生物學家以用戶友好的方式利用大型計算設施的功能。

快速開始

開始使用望遠鏡的步驟很少。有關逐步教程，請單擊此處或此處。

安裝

安裝望遠鏡的最簡單方法是使用pip ：

 pip install git+https://github.com/QCB-Collaboratory/telescope

跑步

安裝後，您將需要兩個文件來運行望遠鏡：（i）定義用戶憑據和服務器地址的配置文件，以及（ii）一個啟動服務器的小型Python腳本。

1. 創建一個名為config.ini的新文件，其中包含以下內容：

 [CREDENTIALS]
USER   = <USERNAME>
SERVER = <SERVER ADDRESS>

[CONFIGURATION]
DATABASE= <DATABASE NAME>

[MONITOR]
NUMUSERS = 1
USER1 = <USERNAME>

如果您使用SSH鍵連接到遠程服務器（強烈建議），則無需密碼字段。除非您想自定義Wiki中所述的路徑，否則請確保將此config.ini保留在當前目錄中。

2. 然後，創建另一個名為RunTelescope.py的文件，其中包含以下內容（注意：望遠鏡存儲庫的測試目錄中有一個副本）：

 import telescope

server = telescope . server ()
server . run ()

最後，運行此Python腳本：

 python RunTelescope.py

這應該可以自動打開使用望遠鏡運行的Web Broswer。有關RunTelescope.py的更多詳細信息可以在Wiki的文檔部分中找到。

如果出現錯誤消息，您可能已經找到了一個錯誤 - 如果您可以舉報，我們將不勝感激。有關更多詳細信息，請訪問我們的Wiki或在Gitter上加入對話。

聯繫，錯誤和建議

如果您發現錯誤和/或對望遠鏡有建議，請

• 打開具有詳細說明的問題；
• 使用吉特與我們交談。

依賴性

望遠鏡可以自我託管，並從用戶列表中跟踪作業。它以python 2.7*或3*的形式運行，具有以下非標準依賴性：

• Paramiko
• pynacl
• 龍捲風
• numpy
• configparser

如果使用pip安裝望遠鏡，這些依賴項將自動安裝。

執照

望遠鏡在GNU通用公共許可證v3.0下共享，請花一點時間閱讀。此CopyLeft許可證的權限是根據提供許可作品和修改的完整源代碼的條件，其中包括使用許可工作的較大作品，並在同一許可下使用許可工作。版權和許可聲明必須保留。貢獻者提供專利權的明確授予。

 Telescope
Copyright (C) 2017  QCB Collaboratory, et al

This material is a free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program. If not, see <http://www.gnu.org/licenses/>.