# azcam-observe
*azcam-observe* is an *azcam* extension for running observing scripts. It can be used
with a Qt-based GUI or with a command line interface.
The *observe* command is usually executed from an console window.
The Qt GUI uses the *PySide2* package.
## Code Documentation
See https://mplesser.github.io/docs/azcam_observe/.
## Installation
`pip install azcam-observe`
Or download from github: https://github.com/mplesser/azcam-observe.git.
## Usage
`observe.start()` to start the GUI. A new window will open.
*GUI example after loading script file.*
After starting the GUI, Press "Select Script" to find a script to load on disk.
Then press "Load Script" to populate the table. The excute, press Run.
You may Pause a script after the current command by pressing the Pause/Resume button.
Then press the same button to resume the script. The "Abort Script" button will
abort the script as soon as possible.
If you have troubles, close the console window and start again.
## GUI Real-time Updates
You may change a cell in the table to update values while a script is running. Click in the cell, make the change and press "Enter" (or click elsewhere).
## Non-GUI Use
It is still possible to run *observe* without the GUI, although this mode is depricated.
## Examples
```python
observe.observe('/azcam/systems/90prime/ObservingScripts/bass.txt',1)
observe.move_telescope_during_readout=1
```
## Parameters
Parameters may be changed from the command line as:
```python
observe.move_telescope_during_readout=1
observe.verbose=1
```
## Script Commands
Always use double quotes (") when needed
Comment lines start with # or !
Status integers are start of a script line are ignored or incremented
```
Observe scripts commands:
obs ExposureTime ImageType Title NumberExposures Filter RA DEC Epoch
stepfocus RelativeNumberSteps
steptel RA_ArcSecs Dec_ArcSecs
movetel RA Dec Epoch
movefilter FilterName
delay NumberSecs
test ExposureTime imagetype Title NumberExposures Filter RA DEC Epoch
print "hi there"
prompt "press any key to continue..."
quit quit script
Example of a script:
obs 10.5 object "M31 field F" 1 u 00:36:00 40:30:00 2000.0
obs 2.3 dark "a test dark" 2 u
stepfocus 50
delay 3.5
stepfocus -50
steptel 12.34 12.34
movetel 112940.40 +310030.0 2000.0
```
Raw data
{
"_id": null,
"home_page": null,
"name": "azcam-observe",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "ccd,imaging,astronomy,sensors",
"author": "Michael Lesser",
"author_email": "mlesser@arizona.edu",
"download_url": "https://files.pythonhosted.org/packages/10/ee/a0a28f8d2b9a295dbd7bf9f32f63409b9cc50389b7f199d0587f9785d326/azcam-observe-22.4.0.tar.gz",
"platform": null,
"description": "# azcam-observe\n\n*azcam-observe* is an *azcam* extension for running observing scripts. It can be used\nwith a Qt-based GUI or with a command line interface.\n\nThe *observe* command is usually executed from an console window. \n\nThe Qt GUI uses the *PySide2* package.\n\n## Code Documentation\n\nSee https://mplesser.github.io/docs/azcam_observe/.\n\n## Installation\n\n`pip install azcam-observe`\n\nOr download from github: https://github.com/mplesser/azcam-observe.git.\n\n## Usage\n\n`observe.start()` to start the GUI. A new window will open.\n\n\n*GUI example after loading script file.*\n\nAfter starting the GUI, Press \"Select Script\" to find a script to load on disk. \nThen press \"Load Script\" to populate the table. The excute, press Run.\nYou may Pause a script after the current command by pressing the Pause/Resume button. \nThen press the same button to resume the script. The \"Abort Script\" button will \nabort the script as soon as possible.\n\nIf you have troubles, close the console window and start again.\n\n## GUI Real-time Updates\n\n You may change a cell in the table to update values while a script is running. Click in the cell, make the change and press \"Enter\" (or click elsewhere).\n \n## Non-GUI Use\n\nIt is still possible to run *observe* without the GUI, although this mode is depricated.\n \n## Examples\n\n```python\nobserve.observe('/azcam/systems/90prime/ObservingScripts/bass.txt',1)\nobserve.move_telescope_during_readout=1\n```\n\n## Parameters\n\n Parameters may be changed from the command line as:\n \n```python\nobserve.move_telescope_during_readout=1\nobserve.verbose=1\n```\n\n## Script Commands\n\nAlways use double quotes (\") when needed\nComment lines start with # or !\nStatus integers are start of a script line are ignored or incremented\n\n```\nObserve scripts commands:\nobs ExposureTime ImageType Title NumberExposures Filter RA DEC Epoch\nstepfocus RelativeNumberSteps\nsteptel RA_ArcSecs Dec_ArcSecs\nmovetel RA Dec Epoch\nmovefilter FilterName\ndelay NumberSecs\ntest ExposureTime imagetype Title NumberExposures Filter RA DEC Epoch\nprint \"hi there\"\nprompt \"press any key to continue...\"\nquit quit script\n\nExample of a script:\nobs 10.5 object \"M31 field F\" 1 u 00:36:00 40:30:00 2000.0 \nobs 2.3 dark \"a test dark\" 2 u\nstepfocus 50\ndelay 3.5\nstepfocus -50\nsteptel 12.34 12.34\nmovetel 112940.40 +310030.0 2000.0\n```\n",
"bugtrack_url": null,
"license": null,
"summary": "Azcam extension for running observing scripts",
"version": "22.4.0",
"split_keywords": [
"ccd",
"imaging",
"astronomy",
"sensors"
],
"urls": [
{
"comment_text": null,
"digests": {
"md5": "69808e13940a7b7eff721bb7598a02b8",
"sha256": "7aee2ff4e60608c5032924f9b4724119b542e48101eb58c02e834c7355e2bc1e"
},
"downloads": -1,
"filename": "azcam_observe-22.4.0-py2.py3-none-any.whl",
"has_sig": false,
"md5_digest": "69808e13940a7b7eff721bb7598a02b8",
"packagetype": "bdist_wheel",
"python_version": "py2.py3",
"requires_python": null,
"size": 21412,
"upload_time": "2022-12-05T01:00:32",
"upload_time_iso_8601": "2022-12-05T01:00:32.495260Z",
"url": "https://files.pythonhosted.org/packages/60/0c/f63a742ae4e7607f3506c4716544438f97a0097ba10ebdd45e2d8928508a/azcam_observe-22.4.0-py2.py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"md5": "2acd4a1d3c6e3e741588ca7bcbd1814f",
"sha256": "90440a3c0bbf7d98cc961645032a387625119cb5207f9edf5bd52fe698895b4b"
},
"downloads": -1,
"filename": "azcam-observe-22.4.0.tar.gz",
"has_sig": false,
"md5_digest": "2acd4a1d3c6e3e741588ca7bcbd1814f",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 246030,
"upload_time": "2022-12-05T01:00:34",
"upload_time_iso_8601": "2022-12-05T01:00:34.893594Z",
"url": "https://files.pythonhosted.org/packages/10/ee/a0a28f8d2b9a295dbd7bf9f32f63409b9cc50389b7f199d0587f9785d326/azcam-observe-22.4.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2022-12-05 01:00:34",
"github": false,
"gitlab": false,
"bitbucket": false,
"lcname": "azcam-observe"
}
JSON