pyobs-asi

This is a pyobs (documentation) module for ASI ZWO cameras.

Example configuration

This is an example configuration, tested on a ASI 071 MC:

class: pyobs_asi.AsiCoolCamera
camera: ZWO ASI071MC Pro

# file naming
filenames: /cache/pyobs-{DAY-OBS|date:}-{FRAMENUM|string:04d}-{IMAGETYP|type}00.fits

# additional fits headers
fits_headers:
  'DET-PIXL': [0.00478, 'Size of detector pixels (square) [mm]']
  'DET-NAME': ['SONY IMX071', 'Name of detector']
  'DET-RON': [2.3, 'Detector readout noise [e-]']
  'DET-SATU': [46000, 'Detector saturation limit [e-]']

# opto-mechanical centre
centre: [2472.0, 1642.0]

# rotation (east of north)
rotation: 3.06
flip: True

# location
timezone: utc
location:
  longitude: 9.944333
  latitude: 51.560583
  elevation: 201.

# communication
comm:
  jid: test@example.com
  password: ***

# virtual file system
vfs:
  class: pyobs.vfs.VirtualFileSystem
  roots:
    cache:
      class: pyobs.vfs.HttpFile
      upload: http://localhost:37075/

Available classes

There are two classes for ASI ZWO cameras: AsiCamera for cameras without cooling, and AsiCoolCamera for cameras with cooling support.

AsiCamera

class AsiCamera(camera: str, sdk: str = '/usr/local/lib/libASICamera2.so', **kwargs: Any)

Bases: BaseCamera, IWindow, IBinning, IImageFormat, IGain, ITemperatures

A pyobs module for ASI cameras.

Initializes a new AsiCamera.

Parameters:

• camera – Name of camera to use.

• sdk – Path to .so file from ASI SDK.

async open() → None

Open module.

async set_binning(x: int, y: int, **kwargs: Any) → None

Set the camera binning.

Parameters:

• x – X binning.

• y – Y binning.

Raises:

ValueError – If binning could not be set.

async set_gain(gain: float, **kwargs: Any) → None

Set the camera gain.

Parameters:

gain – New camera gain.

Raises:

ValueError – If gain could not be set.

async set_image_format(fmt: ImageFormat, **kwargs: Any) → None

Set the camera image format.

Parameters:

fmt – New image format.

Raises:

ValueError – If format could not be set.

async set_offset(offset: float, **kwargs: Any) → None

Set the camera offset.

Parameters:

offset – New camera offset.

Raises:

ValueError – If offset could not be set.

async set_window(left: int, top: int, width: int, height: int, **kwargs: Any) → None

Set the camera window.

Parameters:

• left – X offset of window.

• top – Y offset of window.

• width – Width of window.

• height – Height of window.

Raises:

ValueError – If binning could not be set.

AsiCoolCamera

class AsiCoolCamera(setpoint: int = -20, **kwargs: Any)

Bases: AsiCamera, ICooling

A pyobs module for ASI cameras with cooling.

Initializes a new AsiCoolCamera.

Parameters:

setpoint – Cooling temperature setpoint.

async open() → None

Open module.

async set_cooling(enabled: bool, setpoint: float, **kwargs: Any) → None

Enables/disables cooling and sets setpoint.

Parameters:

• enabled – Enable or disable cooling.

• setpoint – Setpoint in celsius for the cooling.

Raises:

ValueError – If cooling could not be set.