.. _camera-marccd: MarCCD ------ .. image:: marccd.png Introduction ```````````` The SX165 features a round, 165 mm diameter active area, and a versatile, high resolution CCD chip. It is the ideal X-ray detector for research applications with both synchrotrons and rotating anode X-ray sources. Prerequisite ```````````` The MarCCD software server should be started on the MarCCD host computer, by running the command: .. code-block:: bash $ marccd -r Then you can launch your lima/marccd client on another host, as the MarCCD server can be reached by network Installation & Module configuration ``````````````````````````````````` Follow the generic instructions in :ref:`build_installation`. If using CMake directly, add the following flag: .. code-block:: sh -DLIMACAMERA_MARCCD=true For the Tango server installation, refers to :ref:`tango_installation`. Initialisation and Capabilities ``````````````````````````````` Implementing a new plugin for new detector is driven by the LIMA framework but the developer has some freedoms to choose which standard and specific features will be made available. This section is supposed to give you good knowledge regarding camera features within the LIMA framework. Camera initialisation ...................... There are 4 parameters to be filled by your Lima client: - The IP address or hostname (ip_address tango property) of the host where the marccd server is running - The port (port_number tango property) of the marccd server process - The detector target path (image_path tango property): the path where will be saved the marccd image files - Reader timeout: in ms, the timeout after which the plugin will be in fault if no marccd image file is present Std capabilities ................ This plugin has been implemented in respect of the mandatory capabilites but with some limitations according to some programmer's choices. We only provide here extra information for a better understanding of the capabilities for the MarCCD camera. * HwDetInfo - Max image size is : 4096 * 4096 - 16 bit unsigned type is supported * HwSync - trigger type supported are: - IntTrig Optional capabilities ..................... * HwBin - 2 * 2 - 4 * 4 - 8 * 8 * HwRoi TODO Configuration ````````````` No Specific hardware configuration is needed. How to use ```````````` Here is the list of accessible fonctions to configure and use the MarCCD detector: .. code-block:: cpp void getDetectorImageSize(Size& size); void setImagePath(const std::string& path); const std::string& getImagePath(void); void setImageFileName(const std::string& imgName); const std::string& getImageFileName(); void setImageIndex(int newImgIdx); int getImageIndex(); int getFirstImage(); bool isStopSequenceFinished(); void saveBGFrame(bool); void setBeamX(float); float getBeamX(); void setBeamY(float); float getBeamY(); void setDistance(float); float getDistance(); void setWavelength(float); float getWavelength();