Last modified by sndueste on 2024/03/13 14:17
From version 2.1
edited by sendels
on 2019/05/16 12:37
Change comment: There is no comment for this version
To version 20.1
edited by sndueste
on 2024/03/13 14:17
Change comment: There is no comment for this version

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.sendels
1 +XWiki.sndueste
Tags
... ... @@ -1,0 +1,1 @@
1 +favourite
Content
... ... @@ -1,100 +1,165 @@
1 1  (% class="twikiTocTitle" %)Contents:
2 2  
3 -* general Camera info
4 -* Camera server general info
5 -* scaling the image / spectra
6 -* Spectra (line outs) and Gaussian fits
7 -* working with ROIs
8 -* saving images
9 -* Installing new cameras
10 -* Renaming cameras
11 -* special topics
12 -**
13 -*** Background subtraction:
14 -*** Power Over Ethernet
15 -*** Triggering
16 -*** Restarting Servers
17 -* FAQs
18 -* Troubleshooting
19 -** Individual camera manuals
20 -* Cameras used in the FLASH photon diagnostic
21 21  
22 -\\
23 23  
24 -\\
25 25  
26 -== general Camera info ==
6 +{{toc/}}
27 27  
28 -there are several cameras that are watched if they have the correct rep rate and if not the server is restarted every 15 min. here is the list of these cameras [[https:~~/~~/ttfinfo.desy.de/FLASHWiki/Wiki.jsp?page=FlashCamerasToWatch~[~[image:url:http://hasfweb.desy.de/pub/TWiki/TWikiDocGraphics/external-link.gif~|~|width="13" height="12"~]~]>>url:https://ttfinfo.desy.de/FLASHWiki/Wiki.jsp?page=FlashCamerasToWatch||shape="rect"]]
8 +== General Camera info ==
29 29  
30 -\\
10 +**several [[different camera types>>url:https://confluence.desy.de/display/MCS/DOOCS+Camera+Server||shape="rect"]] can be easily integrated into DOOCS. **
31 31  
12 +The details of the available control parameters depends on the camera type. here is a typical view of
13 +
14 +
15 +the Standard view:                                                                                   the controls view:                                                                                                and the Expert view with all available control features
16 +
17 +[[image:attach:image2019-9-19_12-28-30.png||height="400"]][[image:attach:image2019-9-19_12-29-14.png||height="400"]][[image:attach:image2019-9-19_12-29-44.png||height="400"]]
18 +
19 +
20 +
21 +== Troubble shooting / Restarting the camera server ==
22 +
23 +If there are problems occurring with the camera ( no image is shown, no update, camera server crashes ...) then it is** mainly 2 reasons:**
24 +
25 +* **There is no trigger connected to the camera → check with trying to run the camera untriggered ...**
26 +* **the server has problems -> restart the server.**
27 +
28 +Even if it seems unrelated ( camera saved only 0 in the DAQ, reprate can not be changed... ) it turned out that restarting the camera server is helpful.
29 +
30 +1. Best to make a screenshot (in expert mode) to the logbook before restarting in case parameter settings are lost ...
31 +1. goto WDserver and press restart. The camera panel will go red and will come back after about 20 seconds ...
32 +
33 +[[image:attach:image2019-9-24_16-1-16.png||height="400"]]
34 +
35 +
36 +If the restart (several times ...) does not help there is an option to make a "deeper restart". This option uses a restart script which includes power cycling of the camera ( for ethernet cameras)and reloading a standard configuration.  One has to be logged in at a linux computer in order to run the script.
37 +
38 +
39 +[[image:attach:image2019-9-24_16-3-48.png||height="400"]]
40 +
41 +
42 +
43 +== Monitoring system ==
44 +
45 +we implemented a monitoring system for the important beamline cameras in FLASH1 and FLASH2.
46 +
47 +The camera check overview shows a red indicator if the camera is off OR the actual values are different from the saved reference values. Clicking on the red symbol in the camera check one can get to the overview of the parameters. Here a red dot indicates which parameter is different from the reference setting. e.g. if ROI settings have been changed also the reference settings have to be changed accordingly if they are now the new reference !!
48 +
49 +The warning is also shown in the according control panels for the cameras.
50 +
51 +[[image:attach:image2019-9-19_12-26-21.png||height="250"]] [[image:attach:image2019-9-19_12-34-54.png||height="250"]]
52 +
32 32  == Camera server general info ==
33 33  
34 -[[info from the DOOCS pages~[~[image:url:http://hasfweb.desy.de/pub/TWiki/TWikiDocGraphics/external-link.gif~|~|width="13" height="12"~]~]>>url:https://ttfinfo.desy.de/FLASHWiki/Wiki.jsp?page=Camera%20server||shape="rect"]]
55 +[[info from the DOOCS pages>>url:https://ttfinfo.desy.de/FLASHWiki/Wiki.jsp?page=Camera%20server||shape="rect"]]
35 35  
36 36  For the (% class="twikiNewLink" %)CeYAG(%%) camera in the FL1 tunnel Gerhard implemented a feature that during a restart a camera_server.conf.default file is copied as conf file to always have the same settings. if one wants to change something permanently one has to edit the default file. e.g. cp /export/doocs/server/camera_server/camera_server.conf.default /export/doocs/server/camera_server/camera_server.conf
37 37  
38 -\\
39 39  
40 40  == scaling the image / spectra ==
41 41  
42 -\\
62 +[[image:attach:image2019-9-19_12-40-57.png||height="250"]][[image:attach:image2019-9-19_12-59-37.png||height="167"]]
43 43  
64 +one can scale the image with a different scale as pixel.  the center as well as the "pixel size" can be set.
65 +
44 44  == Spectra (line outs) and Gaussian fits ==
45 45  
46 -\\
68 +The camera server can fit the vertical and horizontal averaged data  with a Gaussian fit and provides the corresponding parameters ( height, centroid and width) which have a history and can be used as for optimizing a signal ...
47 47  
70 +
71 +[[image:attach:image2019-9-19_15-3-23.png||height="400"]]
72 +
73 +"Spectrum" of the whole image. this can lead to a wrong fitting ...         
74 +
75 +
76 +
77 +[[image:attach:image2019-9-19_15-5-29.png||height="400"]]
78 +
79 +For a useful fit it is better to look at the "spectrum" of a ROI which can be set to the desired region. Note that the ROI has to be filled (Width = 0) to be correctly averaged!
80 +
81 +
82 +
83 +[[image:attach:image2019-9-19_15-4-20.png||height="250"]]
84 +
85 +For some cameras we also have dedicated Beam profile viewers.
86 +
87 +
88 +
48 48  == working with ROIs ==
49 49  
50 50  To create more ROIs one has to do the following:
51 51  
52 -\\
93 +[[image:attach:image2019-9-19_13-2-26.png||height="400"]]
53 53  
54 -* Define in ENVIRONMENT file the environment variable "(% class="WYSIWYG_TT" %)export FLASH_CAM_ROI_NUM_ENV=xxx(%%)" . With xxx the maximum number of ROIS one needs in a camera controlled by the camera server. (The ENVIRONMENT file is under e.g. export/doocs/hasvuvblfw2/server/camera_server). after editing the ENVIRONMENT file one has to restart the cameraserver.
95 +
96 +* Define in ENVIRONMENT file the environment variable "(% class="WYSIWYG_TT" %)export FLASH_CAM_ROI_NUM_ENV=xxx(%%)" . With xxx the maximum number of ROIS one needs in a camera controlled by the camera server. (The ENVIRONMENT file is under e.g. export/doocs/hasvuvblfw2/server/camera_server). after editing the ENVIRONMENT file one has to restart the camera server.
55 55  * NOTE the file os owned by doocs adm. to edit it one can use (% class="twikiNewLink" %)WinSCP(%%) and log in as doocsadm.
56 56  
57 -\\
58 58  
59 59  * now all cameras have maximum ROIs. if you need less for some cameras read below:
60 60  * Set the required number of ROIs for every camera in the property ROIS.NUM in the configuration file. The way how it's done is the following. On the camera server re-start xxx number of ROIS will be created for every camera. But after reading the configuration file the non-required ROIS will removed for every camera separately according to ROIS.NUM.
61 61  
62 -\\
63 63  
64 -== saving images ==
104 +== saving images "locally" ==
65 65  
66 -The tool writes images of either bmp or an image depemdent format to the specified folder. The folder is on the computer on which the camera server is running (!) and the path starts from the camera server path (!)options
67 -The typical location of the camera server is /export/doocs/server/camera_server/. . if you put "./" in the field Camera Directory. the images in the camera_server directory. It is better to have a separate directory as subfolder like "CameraImages". on some computers this is already installed.
106 +The tool writes images of either bmp or an image depemdent format to the specified folder. The folder is on the computer on which the camera server is running (!) and the path starts from the camera server path (!)options
107 +The typical location of the camera server is /export/doocs/server/camera_server/. . if you put "./" in the field Camera Directory. the images in the camera_server directory. It is better to have a separate directory as subfolder like "CameraImages". on some computers this is already installed.
68 68  Another aproach is to write the files to a home directory. One may put e.g. "/home/vuvfuser/CameraImages/" in the Camera Directory to save on the home directory.
69 69  
70 70  * aquire single images: just press "writing once"
71 71  * aquire a defined number of images: put the number of images in the "count" field and press enter.
72 -* aquire many images. pressing the countinously writing button starts the writing and stops when you press the stop button or the harddisk is 95% full
112 +* aquire many images. pressing the continuously writing button starts the writing and stops when you press the stop button or the hard drive is 95% full
73 73  
74 74  note that youor login has to have the permissions to write in the specified field!
75 75  
76 -\\
77 77  
117 +== Saving images in the DAQ ==
118 +
119 +To save the cameras in the DAQ the server has to have a sender and they have to be "registered" in the DAQ. if this is one one can activate the saving by activating "images"
120 +
121 +[[image:attach:image2023-3-2_14-45-0.png||thumbnail="true" height="250"]]
122 +
123 +if the timing of the sender is not configured correctly it often occurs that the images are saved by one bunch ID "too late"  (-1 has to be substracted by the bunch ID of the camera). one can finetune the sending by optimizing the USR1 time.
124 +
125 +Depending on the binning, bit depth, image size the correct USR1 setting may be different. but typically 40-80 is a good number
126 +
127 +[[image:attach:image2023-3-2_14-48-51.png||height="250"]]
128 +
129 +one can check the mismatch easily by comparing the GMD and the integrated counts on the camera. here an example for USR1 time = 0. (for USR1 >= 20 the correlation is present without bunch ID shift )
130 +
131 +[[image:attach:image2023-3-7_13-49-59.png||thumbnail="true" height="400" width="341"]]
132 +
133 +Here a report where the image saving in the DAQ is investigated in more detail:
134 +
135 +{{view-file att--filename="Report-K.Kharitonov-05.09.2017.pdf"}}{{/view-file}}
136 +
137 + and a more recent "studies"
138 +
139 +{{view-file att--filename="statistic_2023_2.pdf" height="250"/}}
140 +
141 +{{view-file att--filename="Camera_bunchID_shift_V2023_3.pdf" height="250"/}}
142 +
143 +
78 78  == Installing new cameras ==
79 79  
80 80  To install an additional camera to a DOOCS camera server perform the following steps:
81 81  
82 82  * Open the Jddd watchdog panel for the server ((% class="twikiNewLink" %)WatchdogOverview(%%).xml). goto camera server -> locations
83 -* right upper part is a button Divice control
149 +* right upper part is a button Device control
84 84  
85 -[[image:url:http://hasfweb.desy.de/pub/Setup/CameraServerManual/Clipboardadd_camera.jpg||alt="Clipboardadd_camera.jpg" width="455" height="408"]]
151 +[[image:attach:Clipboardadd_camera.jpg||height="400"]]
86 86  
87 -*
153 +*
88 88  ** use action: add
89 89  ** chose FCT code (812 in our case)
90 90  ** add name
91 91  ** press send
92 92  
93 -the you see the new camera in the location table. do ot forget to click "Cfg. restore" in the camer expert pannel onece everything looks o.k. with the camera ( otherwise the cameras may switch with their names ...)
159 +the you see the new camera in the location table. do not forget to click "Cfg. restore" in the camera expert panel once everything looks o.k. with the camera ( otherwise the cameras may switch with their names ...)
94 94  
95 -[[image:url:http://hasfweb.desy.de/pub/Setup/CameraServerManual/screenshot.png||alt="screenshot.png" width="1490" height="950"]]
161 +[[image:attach:screenshot.png||height="400"]]
96 96  
97 -\\
98 98  
99 99  1. First you'll have to open the camera location overview from the watchdog panel
100 100  1*. Enable the camera you wanna edit. If the check mark can't be enabled, you can't talk to the camera.
... ... @@ -109,16 +109,14 @@
109 109  
110 110  While the camera is running one can go to the WD -> locations -> properties ... and then change the NAME to the desired one (NO SPACE CARACTERS IN THE NAME !!!) and press enter ... thats it
111 111  
112 -\\
113 113  
114 114  == special topics ==
115 115  
116 116  ==== Background subtraction: ====
117 117  
118 -* it is important that the values for negative offset are 0. otherwise the substraction does not work (experimental finding by Stefan ...) . For the Basler A311 cameras the mode has to be 5 . for mode 7 the Background substraction does not work... (no resources left)
119 -* For Basler ethernet camera's the offset needs to be zero in anycase, otherwise the server will crash. Also note, you have to make a reference image, that you have to stop/start the image aquisition before you can enable the background-substraction in jddd.
182 +* it is important that the values for negative offset are 0. otherwise the subtraction does not work (experimental finding by Stefan ...) . For the Basler A311 cameras the mode has to be 5 . for mode 7 the Background subtraction does not work... (no resources left)
183 +* For Basler ethernet camera's the offset needs to be zero in any case, otherwise the server will crash. Also note, you have to make a reference image, that you have to stop/start the image acquisition before you can enable the background-subtraction in jddd.
120 120  
121 -\\
122 122  
123 123  ==== Power Over Ethernet ====
124 124  
... ... @@ -136,9 +136,8 @@
136 136  ))).
137 137  * Calling (% class="WYSIWYG_TT" %)//doocs start camera_server// (%%)will include the
138 138  
139 -{{code language="none"}}
140 -PRE_START
141 -{{/code}}// //script, which is by default set to (% class="WYSIWYG_TT" %)///export/doocs/server/script/reload_CAMERA_Server// (%%).
202 +//{{code language="none"}}PRE_START{{/code}} //script, which is by default set to (% class="WYSIWYG_TT" %)///export/doocs/server/script/reload_CAMERA_Server// (%%).
203 +
142 142  * You can also use the (% class="WYSIWYG_TT" %)//!restart!//(%%)button from watchdog server overview. This will execute (% class="WYSIWYG_TT" %)///export/doocs/server/script/reload_CAMERA_server //(%%)directly.
143 143  * The (% class="WYSIWYG_TT" %)//reload_CAMERA_server s//(%%)cript will usually:
144 144  ** Stop capturing on all cameras (optional)
... ... @@ -147,7 +147,6 @@
147 147  ** Restore a default configuration (optional)
148 148  ** Start the camera_server
149 149  
150 -\\
151 151  
152 152  == FAQs ==
153 153  
... ... @@ -154,35 +154,26 @@
154 154  1. //How can I save some images?// you can save images of the camera locally on the computer you are running jddd by clicking the right mouse button and use "save as png..."
155 155  1. //How can I save many images?// goto camera "control" -> "Write images" - a new window opens. With this you can save images (set best to BMP) with timestamp to the computer on which the camera server is running !! (hasftunnelcam1). here the directory in which it safes is : hasftunnelcam1: /export/doocs/server/camera_server/images (if you have the standard setting "./images/" in the directory field). you can get the images with e.g. (% class="twikiNewLink" %)WinSCP(%%). See also help in the "write images" window for more info.
156 156  1. //No images are shown / no update - what to do?// Check if the camera is on (right upper part: Images. the checkbox should be green). If not activate the check box. if this is on but the frames are not counting the trigger might be off. you can check this going to
157 -1. //The cameraserver is unavailable - what to do? See Restarting Server
158 -//
218 +1. //The cameraserver is unavailable - what to do? See Restarting Server//
159 159  
160 -\\
161 -
162 162  == Troubleshooting ==
163 163  
164 164  === Individual camera manuals ===
165 165  
166 -* [[SpectrometerPCOManual>>url:http://hasfweb.desy.de/bin/view/Setup/SpectrometerPCOManual||shape="rect" class="twikiLink"]]
224 +* [[SpectrometerPCOManual>>doc:FLASHUSER.jddd-linked help pages.FLASH1 Tunnel Spectrometer.Things to know about the FLASH1 Spectrometer PCO.WebHome]]
167 167  
168 -\\
169 -
170 170  == Cameras used in the FLASH photon diagnostic ==
171 171  
172 -* [[Basler ace GigE Users Manual>>url:http://hasfweb.desy.de/pub/Setup/CameraServerManual/Basler_ace_GigE_Users_Manual.pdf||shape="rect"]]
228 +* [[Basler ace GigE Users Manual>>attach:Basler_ace_GigE_Users_Manual.pdf]]
173 173  
174 -\\
175 175  
176 -* [[Prosilika User_Manual.pdf>>url:http://hasfweb.desy.de/pub/Setup/CameraServerManual/700013A_-_GE1350_User_Manual.pdf||shape="rect"]]
231 +* [[ Prosilika User_Manual.pdf>>attach:700013A_-_GE1350_User_Manual.pdf]]
177 177  
178 -\\
179 179  
180 -* [[Basler A311f user manual .pdf>>url:http://hasfweb.desy.de/pub/Setup/CameraServerManual/Basler_A311f.pdf||shape="rect"]]
234 +* [[Basler A311f user manual .pdf>>attach:Basler_A311f.pdf]]
181 181  
182 -\\
183 183  
184 -* [[PCO user manual.pdf>>url:http://hasfweb.desy.de/pub/Setup/CameraServerManual/PCO.pdf||shape="rect"]]
237 +* [[PCO user manual.pdf>>attach:PCO.pdf]]
185 185  
186 -\\
187 187  
188 188  * Link to PCO status Sept 2015
700013A_-_GE1350_User_Manual.pdf
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.XWikiGuest
Size
... ... @@ -1,0 +1,1 @@
1 +374.4 KB
Content
Basler_A311f.pdf
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.XWikiGuest
Size
... ... @@ -1,0 +1,1 @@
1 +1.4 MB
Content
Basler_ace_GigE_Users_Manual.pdf
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.XWikiGuest
Size
... ... @@ -1,0 +1,1 @@
1 +3.6 MB
Content
Camera_bunchID_shift_V2023_3.pdf
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.XWikiGuest
Size
... ... @@ -1,0 +1,1 @@
1 +179.6 KB
Content
Clipboardadd_camera.jpg
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.XWikiGuest
Size
... ... @@ -1,0 +1,1 @@
1 +29.8 KB
Content
PCO.pdf
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.XWikiGuest
Size
... ... @@ -1,0 +1,1 @@
1 +557.0 KB
Content
Report-K.Kharitonov-05.09.2017.pdf
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.XWikiGuest
Size
... ... @@ -1,0 +1,1 @@
1 +627.2 KB
Content
image2019-9-19_12-26-21.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.XWikiGuest
Size
... ... @@ -1,0 +1,1 @@
1 +35.3 KB
Content
image2019-9-19_12-28-30.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.XWikiGuest
Size
... ... @@ -1,0 +1,1 @@
1 +53.4 KB
Content
image2019-9-19_12-29-14.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.XWikiGuest
Size
... ... @@ -1,0 +1,1 @@
1 +131.2 KB
Content
image2019-9-19_12-29-44.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.XWikiGuest
Size
... ... @@ -1,0 +1,1 @@
1 +56.9 KB
Content
image2019-9-19_12-34-54.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.XWikiGuest
Size
... ... @@ -1,0 +1,1 @@
1 +21.6 KB
Content
image2019-9-19_12-38-46.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.XWikiGuest
Size
... ... @@ -1,0 +1,1 @@
1 +128.6 KB
Content
image2019-9-19_12-40-57.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.XWikiGuest
Size
... ... @@ -1,0 +1,1 @@
1 +338.8 KB
Content
image2019-9-19_12-59-37.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.XWikiGuest
Size
... ... @@ -1,0 +1,1 @@
1 +5.6 KB
Content
image2019-9-19_13-2-26.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.XWikiGuest
Size
... ... @@ -1,0 +1,1 @@
1 +51.2 KB
Content
image2019-9-19_15-3-23.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.XWikiGuest
Size
... ... @@ -1,0 +1,1 @@
1 +322.3 KB
Content
image2019-9-19_15-4-20.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.XWikiGuest
Size
... ... @@ -1,0 +1,1 @@
1 +154.9 KB
Content
image2019-9-19_15-5-29.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.XWikiGuest
Size
... ... @@ -1,0 +1,1 @@
1 +404.2 KB
Content
image2019-9-24_16-1-16.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.XWikiGuest
Size
... ... @@ -1,0 +1,1 @@
1 +526.6 KB
Content
image2019-9-24_16-3-48.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.XWikiGuest
Size
... ... @@ -1,0 +1,1 @@
1 +732.0 KB
Content
image2023-3-2_14-45-0.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.XWikiGuest
Size
... ... @@ -1,0 +1,1 @@
1 +20.4 KB
Content
image2023-3-2_14-48-51.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.XWikiGuest
Size
... ... @@ -1,0 +1,1 @@
1 +27.9 KB
Content
image2023-3-7_13-49-59.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.XWikiGuest
Size
... ... @@ -1,0 +1,1 @@
1 +61.1 KB
Content
screenshot.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.XWikiGuest
Size
... ... @@ -1,0 +1,1 @@
1 +440.6 KB
Content
statistic_2023_2.pdf
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.XWikiGuest
Size
... ... @@ -1,0 +1,1 @@
1 +168.9 KB
Content