Project

General

Profile

Wiki » History » Version 2

Goret, Gael, 30/01/2015 09:12 AM

1 1 Goret, Gael
2 1 Goret, Gael
[1.1] How to Start-up the 3DRSR execution : 3DRSR_config
3 1 Goret, Gael
4 1 Goret, Gael
The configuration program for 3DRSR is made of two consecutive procedures : firstly an initial auto-assignment of the parameters from configuration file(s) inputted, then, a manual definition of all the parameters that has not been defined automatically.
5 1 Goret, Gael
6 1 Goret, Gael
3DRSR_config is launched in this way:
7 1 Goret, Gael
8 1 Goret, Gael
>>> python 3DRSR_config.py Xcalibur_parameter_file.par [Inhouse_config_file.cfg]
9 1 Goret, Gael
10 1 Goret, Gael
* Inhouse_config_file.cfg being optional
11 1 Goret, Gael
12 1 Goret, Gael
Inhouse_config_file.cfg format (without the “---” lignes): 
13 1 Goret, Gael
14 1 Goret, Gael
--------------------------------------------------------------------------------
15 1 Goret, Gael
# gfs1_2	- file name template
16 1 Goret, Gael
17 1 Goret, Gael
# 1800	- number of input files
18 1 Goret, Gael
19 1 Goret, Gael
# 1		- starting from number
20 1 Goret, Gael
21 1 Goret, Gael
# 2463	- Size-Fastest-Dimension
22 1 Goret, Gael
23 1 Goret, Gael
# 2527	- Size-Second-Dimension
24 1 Goret, Gael
25 1 Goret, Gael
# 0		- starting angle
26 1 Goret, Gael
27 1 Goret, Gael
# 0.1		- oscillation size in degrees
28 1 Goret, Gael
29 1 Goret, Gael
# 1		- apply symmetry (0/1)
30 1 Goret, Gael
31 1 Goret, Gael
# 53.898	- 1st tilt of U matrix
32 1 Goret, Gael
33 1 Goret, Gael
# 29.653	- 2nd tilt of U matrix
34 1 Goret, Gael
35 1 Goret, Gael
# 54.696	- 3rd tilt of U matrix
36 1 Goret, Gael
--------------------------------------------------------------------------------
37 1 Goret, Gael
38 1 Goret, Gael
The configuration procedure start by assigning the parameter values available in the Xcalibur parameter file and (if present) in the inhouse configuration file.
39 1 Goret, Gael
Then the program display a summary of the parameters associated with their values or “None” if the program has failed to initialize one parameter.
40 1 Goret, Gael
41 1 Goret, Gael
Then the program inspect the configuration object and ask the user to set manually the value of each parameter with an undefined value.
42 1 Goret, Gael
43 1 Goret, Gael
At the end of the manual setting procedure, the program display again the list of parameter values, and write an ASCII file, named 3DRSR.conf containing all the information on parameters.
44 1 Goret, Gael
45 1 Goret, Gael
This file can be edited by any text editor in order to modify the configuration before setting the file as input of 3DRSR.  
46 1 Goret, Gael
47 1 Goret, Gael
[1.2] 3DRSR : 3D Reciprocal Space Reconstruction
48 1 Goret, Gael
49 1 Goret, Gael
Once you have obtained a 3DRSR.conf file [see 1.1], you can start 3DRSR using the following syntax :
50 1 Goret, Gael
51 1 Goret, Gael
>>> python 3DRSR.py 3DRSR.conf Filter_file images-file(s)
52 1 Goret, Gael
53 1 Goret, Gael
e.g. : python 3DRSR.py conf/3DRSR.conf mask6M ~/data/GFS/images/*
54 1 Goret, Gael
55 1 Goret, Gael
where,
56 1 Goret, Gael
57 1 Goret, Gael
“conf/3DRSR.conf” is the path to the configuration file,
58 1 Goret, Gael
59 1 Goret, Gael
“mask6M” is the path to the filtering mask (in the example located in the current dir),
60 1 Goret, Gael
61 1 Goret, Gael
“and ~/data/GFS/images/*” is a list of X-ray detector images (given to the program by the command shell via the keyword *)
62 1 Goret, Gael
63 1 Goret, Gael
The Input file formats handled are the following :  
64 1 Goret, Gael
=================== 
65 1 Goret, Gael
* Bruker 
66 1 Goret, Gael
  o brukerimage 
67 1 Goret, Gael
  o bruker100image 
68 1 Goret, Gael
  o kcdimage: Nonius KappaCCD diffractometer 
69 1 Goret, Gael
* Mar Research 
70 1 Goret, Gael
  o marccd (fileformat derived from Tiff) 
71 1 Goret, Gael
  o mar345 imaging plate with PCK compression 
72 1 Goret, Gael
* Dectris 
73 1 Goret, Gael
  o cbfimage (implements a fast byte offset decompression scheme in python/cython) 
74 1 Goret, Gael
  o pilatusimage (fileformat derived from Tiff) 
75 1 Goret, Gael
* ESRF 
76 1 Goret, Gael
  o edfimage: The ESRF data Format 
77 1 Goret, Gael
  o xsdimage: XML serialized image from EDNA 
78 1 Goret, Gael
  o fit2dmaskimage: Fit2d Mask format 
79 1 Goret, Gael
  o fit2dspreadsheetimage: Fit2d ascii tables (spread-sheet) 
80 1 Goret, Gael
* ADSC 
81 1 Goret, Gael
  o adscimage 
82 1 Goret, Gael
* GE detector at APS 
83 1 Goret, Gael
  o GEimage 
84 1 Goret, Gael
* PNM 
85 1 Goret, Gael
  o pnmimage 
86 1 Goret, Gael
* Tiff 
87 1 Goret, Gael
  o tifimage 
88 1 Goret, Gael
* D3M 
89 1 Goret, Gael
  o d3mimage 
90 1 Goret, Gael
* Hamamatsu 
91 1 Goret, Gael
  o HiPiCimage 
92 1 Goret, Gael
* Oxford Diffraction Sapphire 3 
93 1 Goret, Gael
  o OXDimage 
94 1 Goret, Gael
* Nonius 
95 1 Goret, Gael
 o KappaCCD 
96 1 Goret, Gael
* Raw Binary without compression 
97 1 Goret, Gael
=================== 
98 1 Goret, Gael
99 1 Goret, Gael
Once 3DRSR is launched with the proper attributes, the logo is displayed, and the first question appears :  
100 1 Goret, Gael
101 2 Goret, Gael
!3DRSR1.png!