source: trunk/config_example.py @ 3041

Last change on this file since 3041 was 3041, checked in by toby, 4 years ago

Fully implement multiprocessing on reflection loops, but currently disabled, when enabled default is still not to use unless turned on in config; add timing code

  • Property svn:eol-style set to native
  • Property svn:keywords set to Date Author Revision URL Id
File size: 5.7 KB
Line 
1# -*- coding: utf-8 -*-
2#config.py - Variables used to set optional configuration options
3########### SVN repository information ###################
4# $Date: 2017-09-03 16:18:33 +0000 (Sun, 03 Sep 2017) $
5# $Author: toby $
6# $Revision: 3041 $
7# $URL: trunk/config_example.py $
8# $Id: config_example.py 3041 2017-09-03 16:18:33Z toby $
9########### SVN repository information ###################
10'''
11*config_example.py: Configuration options*
12-------------------------------------------
13
14This file contains optional configuration options for GSAS-II. The variables
15in this file can be copied to file config.py, which is imported if present.
16Access these variables using :func:`GSASIIpath.GetConfigValue`, which returns
17None if the variable is not set. Note that a config.py file need not
18be present, but if in use it will typically be found with the GSAS-II source
19directory (GSASIIpath.Path2GSAS2) or a directory for local GSAS-II
20modifications (~/.G2local/ or /Documents and Settings/<User>/.G2local/). 
21
22When defining new config variables for GSAS-II, define them here with a
23default value: use None or a string for strings, or use integers or real
24values. Include a doc string after each variable is defined to explain
25what it does. Use names ending in _location or _directory for items
26that will contain directory names.
27
28For example::
29
30    test_int = 0
31    test_float = 0.0
32    test_string = None (or)
33    test_string = 'value'
34'''
35
36debug = False
37'''Set to True to turn on debugging mode.This enables use of IPython on
38exceptions and on calls to :func:`GSASIIpath.IPyBreak`. Calls to
39:func:`GSASIIpath.pdbBreak` will invoke pdb at that location.
40
41If debug is False, calls to :func:`GSASIIpath.IPyBreak` and
42:func:`GSASIIpath.pdbBreak` are ignored.
43'''
44
45Clip_on = True
46''' if True then line plots willl be clipped at plot border;
47if False line plots extend nto white space around plot frme
48'''
49
50Transpose = False
51'Set to True to cause images to be Transposed when read (for code development)'
52
53Enable_logging = False
54'Set to True to enable use of command logging (under development.)'
55
56logging_debug = False
57'Set to True to enable debug for logging (under development.)'
58
59Help_mode = "browser"
60'''Set to "internal" to use a Python-based web viewer to display
61help documentation and tutorials. If set to the default ("browser")
62the default web browser is used.
63'''
64
65Tutorial_location = None
66'''Change this to place tutorials by in a different spot. If None, this defaults to
67<user>/My Documents/G2tutorials (on windows) or <user>/G2tutorials. If you want to
68use a different location, this can be set here. To install into the location where
69GSAS-II is installed, use this::
70
71    Tutorial_location = GSASIIpath.path2GSAS2
72
73As another example, to use ~/.G2tutorials do this::
74
75    Tutorial_location = '~/.G2tutorials'
76
77Note that os.path.expanduser is run on Tutorial_location before it is used.
78Also note that GSASIIpath is imported inside config.py; other imports should be
79avoided.
80'''
81
82Save_paths=False
83'''When set to True, the last-used path for saving of .gpx and for
84importing of input files is saved in the configuration file.
85Note that since this causes the config.py file to be updated whenever files are
86saved/imported, any temporary config settings can be saved to disk at that
87point.
88'''
89
90Starting_directory=None
91'''Specifies a default location for starting GSAS-II and where .gpx files
92should be read from. Will be updated if Save_paths is True.
93Note that os.path.expanduser is run on this before it is used, so the user's
94home directory can be specified with a '~'.
95'''
96
97Import_directory=None
98'''Specifies a default location for importing (reading) input files. Will be
99updated if Save_paths is True.
100Note that os.path.expanduser is run on this before it is used, so the user's
101home directory can be specified with a '~'.
102'''
103
104wxInspector = False
105'''If set to True, the wxInspector widget is displayed when
106GSAS-II is started.
107'''
108
109Spot_mask_diameter = 1.0
110'''Specifies the default diameter for creation of spot masks. Default is 1.0 mm
111'''
112
113Ring_mask_thickness = 0.1
114'''Specifies the default thickness for creation of ring and arc masks.
115Default is 0.1 degrees 2-theta.
116'''
117
118Arc_mask_azimuth = 10.0
119'''Specifies the default azimuthal range for creation of arc masks.
120Default is 10.0 degrees 2-theta.
121'''
122
123Autoint_PollTime = 30.
124'''Specifies the frequency, in seconds that AutoInt checks for new files.
125Default is 30 seconds
126'''
127
128Autoscale_ParmNames = ['userComment2',r'extraInputs\1\extraInputs','Ion_Chamber_I0',]
129DefaultAutoScale = "userComment2"
130'''Gives the possible selection of incident monitor names as found in an image metadata file.
131DefaultAutoScale must be one of the AutoScale_ParmNames
132Used in AutoIntegration
133'''
134
135Main_Pos = '(100,100)'
136'''Main window location - will be updated & saved when user moves
137it. If position is outside screen then it will be repositioned to default
138'''
139Plot_Pos = '(200,200)'
140'''Plot window location - will be updated & saved when user moves it
141these widows. If position is outside screen then it will be repositioned to default
142'''
143
144Tick_length = 8.0
145'''Specifies the length of phase tick marks in pixels. Default is 8.'''
146
147Tick_width = 1.0
148'''Specifies the width of phase tick marks in pixels.
149Fractional values do seem to produce an effect. Default is 1.'''
150
151Contour_color = 'Paired'
152''' Specifies the color map to be used for contour plots (images, pole figures, etc.)
153'''
154
155Multiprocessing_cores = 0
156''' Specifies the number of cores to use when performing multicore computing. A number less
157than zero causes the recommended number of cores [using multiprocessing.cpu_count()/2]
158to be used. Setting this number to 0 or 1 avoids use of the multiprocessing module: all
159computations are performed in-line.
160'''
161
162Old_protein_validator = True
163''' When True (default) select the old protein validator of Colovos & Yeates (errat) or
164if False use that (erratv2) of Obukhov & Yeates.
165'''
Note: See TracBrowser for help on using the repository browser.