source: trunk/GSASIIctrls.py @ 1709

Last change on this file since 1709 was 1709, checked in by toby, 7 years ago

change sphinx docs links; rebuild & fixing minor formatting

  • Property svn:eol-style set to native
File size: 98.1 KB
Line 
1# -*- coding: utf-8 -*-
2#GSASIIctrls - Custom GSAS-II GUI controls
3########### SVN repository information ###################
4# $Date: $
5# $Author: $
6# $Revision: $
7# $URL: $
8# $Id: $
9########### SVN repository information ###################
10'''
11*GSASIIctrls: Custom GUI controls*
12-------------------------------------------
13
14A library of GUI controls for reuse throughout GSAS-II
15
16(at present many are still in GSASIIgrid, but with time will be moved here)
17
18'''
19import wx
20# import wx.grid as wg
21# import wx.wizard as wz
22# import wx.aui
23import wx.lib.scrolledpanel as wxscroll
24import time
25import copy
26# import cPickle
27import sys
28import os
29# import numpy as np
30# import numpy.ma as ma
31# import scipy.optimize as so
32import wx.html        # could postpone this for quicker startup
33import webbrowser     # could postpone this for quicker startup
34
35import GSASIIpath
36GSASIIpath.SetVersionNumber("$Revision: 1614 $")
37# import GSASIImath as G2mth
38# import GSASIIIO as G2IO
39# import GSASIIstrIO as G2stIO
40# import GSASIIlattice as G2lat
41# import GSASIIplot as G2plt
42import GSASIIpwdGUI as G2pdG
43# import GSASIIimgGUI as G2imG
44# import GSASIIphsGUI as G2phG
45# import GSASIIspc as G2spc
46# import GSASIImapvars as G2mv
47# import GSASIIconstrGUI as G2cnstG
48# import GSASIIrestrGUI as G2restG
49import GSASIIpy3 as G2py3
50# import GSASIIobj as G2obj
51# import GSASIIexprGUI as G2exG
52import GSASIIlog as log
53
54# Define a short names for convenience
55WHITE = (255,255,255)
56DULL_YELLOW = (230,230,190)
57VERY_LIGHT_GREY = wx.Colour(235,235,235)
58WACV = wx.ALIGN_CENTER_VERTICAL
59
60################################################################################
61#### Tree Control
62################################################################################
63class G2TreeCtrl(wx.TreeCtrl):
64    '''Create a wrapper around the standard TreeCtrl so we can "wrap"
65    various events.
66   
67    This logs when a tree item is selected (in :meth:`onSelectionChanged`)
68
69    This also wraps lists and dicts pulled out of the tree to track where
70    they were retrieved from.
71    '''
72    def __init__(self,parent=None,*args,**kwargs):
73        super(self.__class__,self).__init__(parent=parent,*args,**kwargs)
74        self.G2frame = parent.GetParent()
75        self.root = self.AddRoot('Loaded Data: ')
76        self.SelectionChanged = None
77        log.LogInfo['Tree'] = self
78
79    def _getTreeItemsList(self,item):
80        '''Get the full tree hierarchy from a reference to a tree item.
81        Note that this effectively hard-codes phase and histogram names in the
82        returned list. We may want to make these names relative in the future.
83        '''
84        textlist = [self.GetItemText(item)]
85        parent = self.GetItemParent(item)
86        while parent:
87            if parent == self.root: break
88            textlist.insert(0,self.GetItemText(parent))
89            parent = self.GetItemParent(parent)
90        return textlist
91
92    def onSelectionChanged(self,event):
93        '''Log each press on a tree item here.
94        '''
95        if self.SelectionChanged:
96            textlist = self._getTreeItemsList(event.GetItem())
97            if log.LogInfo['Logging'] and event.GetItem() != self.root:
98                textlist[0] = self.GetRelativeHistNum(textlist[0])
99                if textlist[0] == "Phases" and len(textlist) > 1:
100                    textlist[1] = self.GetRelativePhaseNum(textlist[1])
101                log.MakeTreeLog(textlist)
102            self.SelectionChanged(event)
103
104    def Bind(self,eventtype,handler,*args,**kwargs):
105        '''Override the Bind() function so that page change events can be trapped
106        '''
107        if eventtype == wx.EVT_TREE_SEL_CHANGED:
108            self.SelectionChanged = handler
109            wx.TreeCtrl.Bind(self,eventtype,self.onSelectionChanged)
110            return
111        wx.TreeCtrl.Bind(self,eventtype,handler,*args,**kwargs)
112
113    # commented out, disables Logging
114    # def GetItemPyData(self,*args,**kwargs):
115    #    '''Override the standard method to wrap the contents
116    #    so that the source can be logged when changed
117    #    '''
118    #    data = super(self.__class__,self).GetItemPyData(*args,**kwargs)
119    #    textlist = self._getTreeItemsList(args[0])
120    #    if type(data) is dict:
121    #        return log.dictLogged(data,textlist)
122    #    if type(data) is list:
123    #        return log.listLogged(data,textlist)
124    #    if type(data) is tuple: #N.B. tuples get converted to lists
125    #        return log.listLogged(list(data),textlist)
126    #    return data
127
128    def GetRelativeHistNum(self,histname):
129        '''Returns list with a histogram type and a relative number for that
130        histogram, or the original string if not a histogram
131        '''
132        histtype = histname.split()[0]
133        if histtype != histtype.upper(): # histograms (only) have a keyword all in caps
134            return histname
135        item, cookie = self.GetFirstChild(self.root)
136        i = 0
137        while item:
138            itemtext = self.GetItemText(item)
139            if itemtext == histname:
140                return histtype,i
141            elif itemtext.split()[0] == histtype:
142                i += 1
143            item, cookie = self.GetNextChild(self.root, cookie)
144        else:
145            raise Exception("Histogram not found: "+histname)
146
147    def ConvertRelativeHistNum(self,histtype,histnum):
148        '''Converts a histogram type and relative histogram number to a
149        histogram name in the current project
150        '''
151        item, cookie = self.GetFirstChild(self.root)
152        i = 0
153        while item:
154            itemtext = self.GetItemText(item)
155            if itemtext.split()[0] == histtype:
156                if i == histnum: return itemtext
157                i += 1
158            item, cookie = self.GetNextChild(self.root, cookie)
159        else:
160            raise Exception("Histogram #'+str(histnum)+' of type "+histtype+' not found')
161       
162    def GetRelativePhaseNum(self,phasename):
163        '''Returns a phase number if the string matches a phase name
164        or else returns the original string
165        '''
166        item, cookie = self.GetFirstChild(self.root)
167        while item:
168            itemtext = self.GetItemText(item)
169            if itemtext == "Phases":
170                parent = item
171                item, cookie = self.GetFirstChild(parent)
172                i = 0
173                while item:
174                    itemtext = self.GetItemText(item)
175                    if itemtext == phasename:
176                        return i
177                    item, cookie = self.GetNextChild(parent, cookie)
178                    i += 1
179                else:
180                    return phasename # not a phase name
181            item, cookie = self.GetNextChild(self.root, cookie)
182        else:
183            raise Exception("No phases found ")
184
185    def ConvertRelativePhaseNum(self,phasenum):
186        '''Converts relative phase number to a phase name in
187        the current project
188        '''
189        item, cookie = self.GetFirstChild(self.root)
190        while item:
191            itemtext = self.GetItemText(item)
192            if itemtext == "Phases":
193                parent = item
194                item, cookie = self.GetFirstChild(parent)
195                i = 0
196                while item:
197                    if i == phasenum:
198                        return self.GetItemText(item)
199                    item, cookie = self.GetNextChild(parent, cookie)
200                    i += 1
201                else:
202                    raise Exception("Phase "+str(phasenum)+" not found")
203            item, cookie = self.GetNextChild(self.root, cookie)
204        else:
205            raise Exception("No phases found ")
206
207################################################################################
208#### TextCtrl that stores input as entered with optional validation
209################################################################################
210class ValidatedTxtCtrl(wx.TextCtrl):
211    '''Create a TextCtrl widget that uses a validator to prevent the
212    entry of inappropriate characters and changes color to highlight
213    when invalid input is supplied. As valid values are typed,
214    they are placed into the dict or list where the initial value
215    came from. The type of the initial value must be int,
216    float or str or None (see :obj:`key` and :obj:`typeHint`);
217    this type (or the one in :obj:`typeHint`) is preserved.
218
219    Float values can be entered in the TextCtrl as numbers or also
220    as algebraic expressions using operators + - / \* () and \*\*,
221    in addition pi, sind(), cosd(), tand(), and sqrt() can be used,
222    as well as appreviations s, sin, c, cos, t, tan and sq.
223
224    :param wx.Panel parent: name of panel or frame that will be
225      the parent to the TextCtrl. Can be None.
226
227    :param dict/list loc: the dict or list with the initial value to be
228      placed in the TextCtrl.
229
230    :param int/str key: the dict key or the list index for the value to be
231      edited by the TextCtrl. The ``loc[key]`` element must exist, but may
232      have value None. If None, the type for the element is taken from
233      :obj:`typeHint` and the value for the control is set initially
234      blank (and thus invalid.) This is a way to specify a field without a
235      default value: a user must set a valid value.
236      If the value is not None, it must have a base
237      type of int, float, str or unicode; the TextCrtl will be initialized
238      from this value.
239     
240    :param list nDig: number of digits & places ([nDig,nPlc]) after decimal to use
241      for display of float. Alternately, None can be specified which causes
242      numbers to be displayed with approximately 5 significant figures
243      (Default=None).
244
245    :param bool notBlank: if True (default) blank values are invalid
246      for str inputs.
247     
248    :param number min: minimum allowed valid value. If None (default) the
249      lower limit is unbounded.
250
251    :param number max: maximum allowed valid value. If None (default) the
252      upper limit is unbounded
253
254    :param function OKcontrol: specifies a function or method that will be
255      called when the input is validated. The called function is supplied
256      with one argument which is False if the TextCtrl contains an invalid
257      value and True if the value is valid.
258      Note that this function should check all values
259      in the dialog when True, since other entries might be invalid.
260      The default for this is None, which indicates no function should
261      be called.
262
263    :param function OnLeave: specifies a function or method that will be
264      called when the focus for the control is lost.
265      The called function is supplied with (at present) three keyword arguments:
266
267         * invalid: (*bool*) True if the value for the TextCtrl is invalid
268         * value:   (*int/float/str*)  the value contained in the TextCtrl
269         * tc:      (*wx.TextCtrl*)  the TextCtrl name
270
271      The number of keyword arguments may be increased in the future should needs arise,
272      so it is best to code these functions with a \*\*kwargs argument so they will
273      continue to run without errors
274
275      The default for OnLeave is None, which indicates no function should
276      be called.
277
278    :param type typeHint: the value of typeHint is overrides the initial value
279      for the dict/list element ``loc[key]``, if set to
280      int or float, which specifies the type for input to the TextCtrl.
281      Defaults as None, which is ignored.
282
283    :param bool CIFinput: for str input, indicates that only printable
284      ASCII characters may be entered into the TextCtrl. Forces output
285      to be ASCII rather than Unicode. For float and int input, allows
286      use of a single '?' or '.' character as valid input.
287
288    :param dict OnLeaveArgs: a dict with keyword args that are passed to
289      the :attr:`OnLeave` function. Defaults to ``{}``
290
291    :param (other): other optional keyword parameters for the
292      wx.TextCtrl widget such as size or style may be specified.
293
294    '''
295    def __init__(self,parent,loc,key,nDig=None,notBlank=True,min=None,max=None,
296                 OKcontrol=None,OnLeave=None,typeHint=None,
297                 CIFinput=False, OnLeaveArgs={}, **kw):
298        # save passed values needed outside __init__
299        self.result = loc
300        self.key = key
301        self.nDig = nDig
302        self.OKcontrol=OKcontrol
303        self.OnLeave = OnLeave
304        self.OnLeaveArgs = OnLeaveArgs
305        self.CIFinput = CIFinput
306        self.type = str
307        # initialization
308        self.invalid = False   # indicates if the control has invalid contents
309        self.evaluated = False # set to True when the validator recognizes an expression
310        val = loc[key]
311        if isinstance(val,int) or typeHint is int:
312            self.type = int
313            wx.TextCtrl.__init__(
314                self,parent,wx.ID_ANY,
315                validator=NumberValidator(int,result=loc,key=key,
316                                          min=min,max=max,
317                                          OKcontrol=OKcontrol,
318                                          CIFinput=CIFinput),
319                **kw)
320            if val is not None:
321                self._setValue(val)
322            else: # no default is invalid for a number
323                self.invalid = True
324                self._IndicateValidity()
325
326        elif isinstance(val,float) or typeHint is float:
327            self.type = float
328            wx.TextCtrl.__init__(
329                self,parent,wx.ID_ANY,
330                validator=NumberValidator(float,result=loc,key=key,
331                                          min=min,max=max,
332                                          OKcontrol=OKcontrol,
333                                          CIFinput=CIFinput),
334                **kw)
335            if val is not None:
336                self._setValue(val)
337            else:
338                self.invalid = True
339                self._IndicateValidity()
340
341        elif isinstance(val,str) or isinstance(val,unicode):
342            if self.CIFinput:
343                wx.TextCtrl.__init__(
344                    self,parent,wx.ID_ANY,val,
345                    validator=ASCIIValidator(result=loc,key=key),
346                    **kw)
347            else:
348                wx.TextCtrl.__init__(self,parent,wx.ID_ANY,val,**kw)
349            if notBlank:
350                self.Bind(wx.EVT_CHAR,self._onStringKey)
351                self.ShowStringValidity() # test if valid input
352            else:
353                self.invalid = False
354                self.Bind(wx.EVT_CHAR,self._GetStringValue)
355        elif val is None:
356            raise Exception,("ValidatedTxtCtrl error: value of "+str(key)+
357                             " element is None and typeHint not defined as int or float")
358        else:
359            raise Exception,("ValidatedTxtCtrl error: Unknown element ("+str(key)+
360                             ") type: "+str(type(val)))
361        # When the mouse is moved away or the widget loses focus,
362        # display the last saved value, if an expression
363        #self.Bind(wx.EVT_LEAVE_WINDOW, self._onLeaveWindow)
364        self.Bind(wx.EVT_TEXT_ENTER, self._onLoseFocus)
365        self.Bind(wx.EVT_KILL_FOCUS, self._onLoseFocus)
366        # patch for wx 2.9 on Mac
367        i,j= wx.__version__.split('.')[0:2]
368        if int(i)+int(j)/10. > 2.8 and 'wxOSX' in wx.PlatformInfo:
369            self.Bind(wx.EVT_KEY_DOWN, self.OnKeyDown)
370
371    def SetValue(self,val):
372        if self.result is not None: # note that this bypasses formatting
373            self.result[self.key] = val
374            log.LogVarChange(self.result,self.key)
375        self._setValue(val)
376
377    def _setValue(self,val):
378        self.invalid = False
379        if self.type is int:
380            try:
381                if int(val) != val:
382                    self.invalid = True
383                else:
384                    val = int(val)
385            except:
386                if self.CIFinput and (val == '?' or val == '.'):
387                    pass
388                else:
389                    self.invalid = True
390            wx.TextCtrl.SetValue(self,str(val))
391        elif self.type is float:
392            try:
393                val = float(val) # convert strings, if needed
394            except:
395                if self.CIFinput and (val == '?' or val == '.'):
396                    pass
397                else:
398                    self.invalid = True
399            if self.nDig:
400                wx.TextCtrl.SetValue(self,str(G2py3.FormatValue(val,self.nDig)))
401            else:
402                wx.TextCtrl.SetValue(self,str(G2py3.FormatSigFigs(val)).rstrip('0'))
403        else:
404            wx.TextCtrl.SetValue(self,str(val))
405            self.ShowStringValidity() # test if valid input
406            return
407       
408        self._IndicateValidity()
409        if self.OKcontrol:
410            self.OKcontrol(not self.invalid)
411
412    def OnKeyDown(self,event):
413        'Special callback for wx 2.9+ on Mac where backspace is not processed by validator'
414        key = event.GetKeyCode()
415        if key in [wx.WXK_BACK, wx.WXK_DELETE]:
416            if self.Validator: wx.CallAfter(self.Validator.TestValid,self)
417        if key == wx.WXK_RETURN:
418            self._onLoseFocus(None)
419        event.Skip()
420                   
421    def _onStringKey(self,event):
422        event.Skip()
423        if self.invalid: # check for validity after processing the keystroke
424            wx.CallAfter(self.ShowStringValidity,True) # was invalid
425        else:
426            wx.CallAfter(self.ShowStringValidity,False) # was valid
427
428    def _IndicateValidity(self):
429        'Set the control colors to show invalid input'
430        if self.invalid:
431            self.SetForegroundColour("red")
432            self.SetBackgroundColour("yellow")
433            self.SetFocus()
434            self.Refresh()
435        else: # valid input
436            self.SetBackgroundColour(
437                wx.SystemSettings_GetColour(wx.SYS_COLOUR_WINDOW))
438            self.SetForegroundColour("black")
439            self.Refresh()
440
441    def ShowStringValidity(self,previousInvalid=True):
442        '''Check if input is valid. Anytime the input is
443        invalid, call self.OKcontrol (if defined) because it is fast.
444        If valid, check for any other invalid entries only when
445        changing from invalid to valid, since that is slower.
446       
447        :param bool previousInvalid: True if the TextCtrl contents were
448          invalid prior to the current change.
449         
450        '''
451        val = self.GetValue().strip()
452        self.invalid = not val
453        self._IndicateValidity()
454        if self.invalid:
455            if self.OKcontrol:
456                self.OKcontrol(False)
457        elif self.OKcontrol and previousInvalid:
458            self.OKcontrol(True)
459        # always store the result
460        if self.CIFinput: # for CIF make results ASCII
461            self.result[self.key] = val.encode('ascii','replace') 
462        else:
463            self.result[self.key] = val
464        log.LogVarChange(self.result,self.key)
465
466    def _GetStringValue(self,event):
467        '''Get string input and store.
468        '''
469        event.Skip() # process keystroke
470        wx.CallAfter(self._SaveStringValue)
471       
472    def _SaveStringValue(self):
473        val = self.GetValue().strip()
474        # always store the result
475        if self.CIFinput: # for CIF make results ASCII
476            self.result[self.key] = val.encode('ascii','replace') 
477        else:
478            self.result[self.key] = val
479        log.LogVarChange(self.result,self.key)
480
481    def _onLoseFocus(self,event):
482        if self.evaluated:
483            self.EvaluateExpression()
484        elif self.result is not None: # show formatted result, as Bob wants
485            self._setValue(self.result[self.key])
486        if self.OnLeave: self.OnLeave(invalid=self.invalid,
487                                      value=self.result[self.key],
488                                      tc=self,
489                                      **self.OnLeaveArgs)
490        if event: event.Skip()
491
492    def EvaluateExpression(self):
493        '''Show the computed value when an expression is entered to the TextCtrl
494        Make sure that the number fits by truncating decimal places and switching
495        to scientific notation, as needed.
496        Called on loss of focus, enter, etc..
497        '''
498        if self.invalid: return # don't substitute for an invalid expression
499        if not self.evaluated: return # true when an expression is evaluated
500        if self.result is not None: # retrieve the stored result
501            self._setValue(self.result[self.key])
502        self.evaluated = False # expression has been recast as value, reset flag
503       
504class NumberValidator(wx.PyValidator):
505    '''A validator to be used with a TextCtrl to prevent
506    entering characters other than digits, signs, and for float
507    input, a period and exponents.
508   
509    The value is checked for validity after every keystroke
510      If an invalid number is entered, the box is highlighted.
511      If the number is valid, it is saved in result[key]
512
513    :param type typ: the base data type. Must be int or float.
514
515    :param bool positiveonly: If True, negative integers are not allowed
516      (default False). This prevents the + or - keys from being pressed.
517      Used with typ=int; ignored for typ=float.
518
519    :param number min: Minimum allowed value. If None (default) the
520      lower limit is unbounded
521
522    :param number max: Maximum allowed value. If None (default) the
523      upper limit is unbounded
524     
525    :param dict/list result: List or dict where value should be placed when valid
526
527    :param any key: key to use for result (int for list)
528
529    :param function OKcontrol: function or class method to control
530      an OK button for a window.
531      Ignored if None (default)
532
533    :param bool CIFinput: allows use of a single '?' or '.' character
534      as valid input.
535     
536    '''
537    def __init__(self, typ, positiveonly=False, min=None, max=None,
538                 result=None, key=None, OKcontrol=None, CIFinput=False):
539        'Create the validator'
540        wx.PyValidator.__init__(self)
541        # save passed parameters
542        self.typ = typ
543        self.positiveonly = positiveonly
544        self.min = min
545        self.max = max
546        self.result = result
547        self.key = key
548        self.OKcontrol = OKcontrol
549        self.CIFinput = CIFinput
550        # set allowed keys by data type
551        self.Bind(wx.EVT_CHAR, self.OnChar)
552        if self.typ == int and self.positiveonly:
553            self.validchars = '0123456789'
554        elif self.typ == int:
555            self.validchars = '0123456789+-'
556        elif self.typ == float:
557            # allow for above and sind, cosd, sqrt, tand, pi, and abbreviations
558            # also addition, subtraction, division, multiplication, exponentiation
559            self.validchars = '0123456789.-+eE/cosindcqrtap()*'
560        else:
561            self.validchars = None
562            return
563        if self.CIFinput:
564            self.validchars += '?.'
565    def Clone(self):
566        'Create a copy of the validator, a strange, but required component'
567        return NumberValidator(typ=self.typ, 
568                               positiveonly=self.positiveonly,
569                               min=self.min, max=self.max,
570                               result=self.result, key=self.key,
571                               OKcontrol=self.OKcontrol,
572                               CIFinput=self.CIFinput)
573    def TransferToWindow(self):
574        'Needed by validator, strange, but required component'
575        return True # Prevent wxDialog from complaining.
576    def TransferFromWindow(self):
577        'Needed by validator, strange, but required component'
578        return True # Prevent wxDialog from complaining.
579    def TestValid(self,tc):
580        '''Check if the value is valid by casting the input string
581        into the current type.
582
583        Set the invalid variable in the TextCtrl object accordingly.
584
585        If the value is valid, save it in the dict/list where
586        the initial value was stored, if appropriate.
587
588        :param wx.TextCtrl tc: A reference to the TextCtrl that the validator
589          is associated with.
590        '''
591        tc.invalid = False # assume valid
592        if self.CIFinput:
593            val = tc.GetValue().strip()
594            if val == '?' or val == '.':
595                self.result[self.key] = val
596                log.LogVarChange(self.result,self.key)
597                return
598        try:
599            val = self.typ(tc.GetValue())
600        except (ValueError, SyntaxError) as e:
601            if self.typ is float: # for float values, see if an expression can be evaluated
602                val = G2py3.FormulaEval(tc.GetValue())
603                if val is None:
604                    tc.invalid = True
605                    return
606                else:
607                    tc.evaluated = True
608            else: 
609                tc.invalid = True
610                return
611        # if self.max != None and self.typ == int:
612        #     if val > self.max:
613        #         tc.invalid = True
614        # if self.min != None and self.typ == int:
615        #     if val < self.min:
616        #         tc.invalid = True  # invalid
617        if self.max != None:
618            if val > self.max:
619                tc.invalid = True
620        if self.min != None:
621            if val < self.min:
622                tc.invalid = True  # invalid
623        if self.key is not None and self.result is not None and not tc.invalid:
624            self.result[self.key] = val
625            log.LogVarChange(self.result,self.key)
626
627    def ShowValidity(self,tc):
628        '''Set the control colors to show invalid input
629
630        :param wx.TextCtrl tc: A reference to the TextCtrl that the validator
631          is associated with.
632
633        '''
634        if tc.invalid:
635            tc.SetForegroundColour("red")
636            tc.SetBackgroundColour("yellow")
637            tc.SetFocus()
638            tc.Refresh()
639            return False
640        else: # valid input
641            tc.SetBackgroundColour(
642                wx.SystemSettings_GetColour(wx.SYS_COLOUR_WINDOW))
643            tc.SetForegroundColour("black")
644            tc.Refresh()
645            return True
646
647    def CheckInput(self,previousInvalid):
648        '''called to test every change to the TextCtrl for validity and
649        to change the appearance of the TextCtrl
650
651        Anytime the input is invalid, call self.OKcontrol
652        (if defined) because it is fast.
653        If valid, check for any other invalid entries only when
654        changing from invalid to valid, since that is slower.
655
656        :param bool previousInvalid: True if the TextCtrl contents were
657          invalid prior to the current change.
658        '''
659        tc = self.GetWindow()
660        self.TestValid(tc)
661        self.ShowValidity(tc)
662        # if invalid
663        if tc.invalid and self.OKcontrol:
664            self.OKcontrol(False)
665        if not tc.invalid and self.OKcontrol and previousInvalid:
666            self.OKcontrol(True)
667
668    def OnChar(self, event):
669        '''Called each type a key is pressed
670        ignores keys that are not allowed for int and float types
671        '''
672        key = event.GetKeyCode()
673        tc = self.GetWindow()
674        if key == wx.WXK_RETURN:
675            if tc.invalid:
676                self.CheckInput(True) 
677            else:
678                self.CheckInput(False) 
679            return
680        if key < wx.WXK_SPACE or key == wx.WXK_DELETE or key > 255: # control characters get processed
681            event.Skip()
682            if tc.invalid:
683                wx.CallAfter(self.CheckInput,True) 
684            else:
685                wx.CallAfter(self.CheckInput,False) 
686            return
687        elif chr(key) in self.validchars: # valid char pressed?
688            event.Skip()
689            if tc.invalid:
690                wx.CallAfter(self.CheckInput,True) 
691            else:
692                wx.CallAfter(self.CheckInput,False) 
693            return
694        if not wx.Validator_IsSilent(): wx.Bell()
695        return  # Returning without calling event.Skip, which eats the keystroke
696
697class ASCIIValidator(wx.PyValidator):
698    '''A validator to be used with a TextCtrl to prevent
699    entering characters other than ASCII characters.
700   
701    The value is checked for validity after every keystroke
702      If an invalid number is entered, the box is highlighted.
703      If the number is valid, it is saved in result[key]
704
705    :param dict/list result: List or dict where value should be placed when valid
706
707    :param any key: key to use for result (int for list)
708
709    '''
710    def __init__(self, result=None, key=None):
711        'Create the validator'
712        import string
713        wx.PyValidator.__init__(self)
714        # save passed parameters
715        self.result = result
716        self.key = key
717        self.validchars = string.ascii_letters + string.digits + string.punctuation + string.whitespace
718        self.Bind(wx.EVT_CHAR, self.OnChar)
719    def Clone(self):
720        'Create a copy of the validator, a strange, but required component'
721        return ASCIIValidator(result=self.result, key=self.key)
722        tc = self.GetWindow()
723        tc.invalid = False # make sure the validity flag is defined in parent
724    def TransferToWindow(self):
725        'Needed by validator, strange, but required component'
726        return True # Prevent wxDialog from complaining.
727    def TransferFromWindow(self):
728        'Needed by validator, strange, but required component'
729        return True # Prevent wxDialog from complaining.
730    def TestValid(self,tc):
731        '''Check if the value is valid by casting the input string
732        into ASCII.
733
734        Save it in the dict/list where the initial value was stored
735
736        :param wx.TextCtrl tc: A reference to the TextCtrl that the validator
737          is associated with.
738        '''
739        self.result[self.key] = tc.GetValue().encode('ascii','replace')
740        log.LogVarChange(self.result,self.key)
741
742    def OnChar(self, event):
743        '''Called each type a key is pressed
744        ignores keys that are not allowed for int and float types
745        '''
746        key = event.GetKeyCode()
747        tc = self.GetWindow()
748        if key == wx.WXK_RETURN:
749            self.TestValid(tc)
750            return
751        if key < wx.WXK_SPACE or key == wx.WXK_DELETE or key > 255: # control characters get processed
752            event.Skip()
753            self.TestValid(tc)
754            return
755        elif chr(key) in self.validchars: # valid char pressed?
756            event.Skip()
757            self.TestValid(tc)
758            return
759        if not wx.Validator_IsSilent():
760            wx.Bell()
761        return  # Returning without calling event.Skip, which eats the keystroke
762
763################################################################################
764#### Edit a large number of values
765################################################################################
766def CallScrolledMultiEditor(parent,dictlst,elemlst,prelbl=[],postlbl=[],
767                 title='Edit items',header='',size=(300,250),
768                             CopyButton=False, **kw):
769    '''Shell routine to call a ScrolledMultiEditor dialog. See
770    :class:`ScrolledMultiEditor` for parameter definitions.
771
772    :returns: True if the OK button is pressed; False if the window is closed
773      with the system menu or the Cancel button.
774
775    '''
776    dlg = ScrolledMultiEditor(parent,dictlst,elemlst,prelbl,postlbl,
777                              title,header,size,
778                              CopyButton, **kw)
779    if dlg.ShowModal() == wx.ID_OK:
780        dlg.Destroy()
781        return True
782    else:
783        dlg.Destroy()
784        return False
785
786class ScrolledMultiEditor(wx.Dialog):
787    '''Define a window for editing a potentially large number of dict- or
788    list-contained values with validation for each item. Edited values are
789    automatically placed in their source location. If invalid entries
790    are provided, the TextCtrl is turned yellow and the OK button is disabled.
791
792    The type for each TextCtrl validation is determined by the
793    initial value of the entry (int, float or string).
794    Float values can be entered in the TextCtrl as numbers or also
795    as algebraic expressions using operators + - / \* () and \*\*,
796    in addition pi, sind(), cosd(), tand(), and sqrt() can be used,
797    as well as appreviations s(), sin(), c(), cos(), t(), tan() and sq().
798
799    :param wx.Frame parent: name of parent window, or may be None
800
801    :param tuple dictlst: a list of dicts or lists containing values to edit
802
803    :param tuple elemlst: a list of keys for each item in a dictlst. Must have the
804      same length as dictlst.
805
806    :param wx.Frame parent: name of parent window, or may be None
807   
808    :param tuple prelbl: a list of labels placed before the TextCtrl for each
809      item (optional)
810   
811    :param tuple postlbl: a list of labels placed after the TextCtrl for each
812      item (optional)
813
814    :param str title: a title to place in the frame of the dialog
815
816    :param str header: text to place at the top of the window. May contain
817      new line characters.
818
819    :param wx.Size size: a size parameter that dictates the
820      size for the scrolled region of the dialog. The default is
821      (300,250).
822
823    :param bool CopyButton: if True adds a small button that copies the
824      value for the current row to all fields below (default is False)
825     
826    :param list minvals: optional list of minimum values for validation
827      of float or int values. Ignored if value is None.
828    :param list maxvals: optional list of maximum values for validation
829      of float or int values. Ignored if value is None.
830    :param list sizevals: optional list of wx.Size values for each input
831      widget. Ignored if value is None.
832     
833    :param tuple checkdictlst: an optional list of dicts or lists containing bool
834      values (similar to dictlst).
835    :param tuple checkelemlst: an optional list of dicts or lists containing bool
836      key values (similar to elemlst). Must be used with checkdictlst.
837    :param string checklabel: a string to use for each checkbutton
838     
839    :returns: the wx.Dialog created here. Use method .ShowModal() to display it.
840   
841    *Example for use of ScrolledMultiEditor:*
842
843    ::
844
845        dlg = <pkg>.ScrolledMultiEditor(frame,dictlst,elemlst,prelbl,postlbl,
846                                        header=header)
847        if dlg.ShowModal() == wx.ID_OK:
848             for d,k in zip(dictlst,elemlst):
849                 print d[k]
850
851    *Example definitions for dictlst and elemlst:*
852
853    ::
854     
855          dictlst = (dict1,list1,dict1,list1)
856          elemlst = ('a', 1, 2, 3)
857
858      This causes items dict1['a'], list1[1], dict1[2] and list1[3] to be edited.
859   
860    Note that these items must have int, float or str values assigned to
861    them. The dialog will force these types to be retained. String values
862    that are blank are marked as invalid.
863    '''
864   
865    def __init__(self,parent,dictlst,elemlst,prelbl=[],postlbl=[],
866                 title='Edit items',header='',size=(300,250),
867                 CopyButton=False,
868                 minvals=[],maxvals=[],sizevals=[],
869                 checkdictlst=[], checkelemlst=[], checklabel=""):
870        if len(dictlst) != len(elemlst):
871            raise Exception,"ScrolledMultiEditor error: len(dictlst) != len(elemlst) "+str(len(dictlst))+" != "+str(len(elemlst))
872        if len(checkdictlst) != len(checkelemlst):
873            raise Exception,"ScrolledMultiEditor error: len(checkdictlst) != len(checkelemlst) "+str(len(checkdictlst))+" != "+str(len(checkelemlst))
874        wx.Dialog.__init__( # create dialog & sizer
875            self,parent,wx.ID_ANY,title,
876            style=wx.DEFAULT_DIALOG_STYLE|wx.RESIZE_BORDER)
877        mainSizer = wx.BoxSizer(wx.VERTICAL)
878        self.orig = []
879        self.dictlst = dictlst
880        self.elemlst = elemlst
881        self.checkdictlst = checkdictlst
882        self.checkelemlst = checkelemlst
883        self.StartCheckValues = [checkdictlst[i][checkelemlst[i]] for i in range(len(checkdictlst))]
884        self.ButtonIndex = {}
885        for d,i in zip(dictlst,elemlst):
886            self.orig.append(d[i])
887        # add a header if supplied
888        if header:
889            subSizer = wx.BoxSizer(wx.HORIZONTAL)
890            subSizer.Add((-1,-1),1,wx.EXPAND)
891            subSizer.Add(wx.StaticText(self,wx.ID_ANY,header))
892            subSizer.Add((-1,-1),1,wx.EXPAND)
893            mainSizer.Add(subSizer,0,wx.EXPAND,0)
894        # make OK button now, because we will need it for validation
895        self.OKbtn = wx.Button(self, wx.ID_OK)
896        self.OKbtn.SetDefault()
897        # create scrolled panel and sizer
898        panel = wxscroll.ScrolledPanel(self, wx.ID_ANY,size=size,
899            style = wx.TAB_TRAVERSAL|wx.SUNKEN_BORDER)
900        cols = 4
901        if CopyButton: cols += 1
902        subSizer = wx.FlexGridSizer(cols=cols,hgap=2,vgap=2)
903        self.ValidatedControlsList = [] # make list of TextCtrls
904        self.CheckControlsList = [] # make list of CheckBoxes
905        for i,(d,k) in enumerate(zip(dictlst,elemlst)):
906            if i >= len(prelbl): # label before TextCtrl, or put in a blank
907                subSizer.Add((-1,-1)) 
908            else:
909                subSizer.Add(wx.StaticText(panel,wx.ID_ANY,str(prelbl[i])))
910            kargs = {}
911            if i < len(minvals):
912                if minvals[i] is not None: kargs['min']=minvals[i]
913            if i < len(maxvals):
914                if maxvals[i] is not None: kargs['max']=maxvals[i]
915            if i < len(sizevals):
916                if sizevals[i]: kargs['size']=sizevals[i]
917            if CopyButton:
918                import wx.lib.colourselect as wscs
919                but = wscs.ColourSelect(label='v', # would like to use u'\u2193' or u'\u25BC' but not in WinXP
920                                        # is there a way to test?
921                                        parent=panel,
922                                        colour=(255,255,200),
923                                        size=wx.Size(30,23),
924                                        style=wx.RAISED_BORDER)
925                but.Bind(wx.EVT_BUTTON, self._OnCopyButton)
926                but.SetToolTipString('Press to copy adjacent value to all rows below')
927                self.ButtonIndex[but] = i
928                subSizer.Add(but)
929            # create the validated TextCrtl, store it and add it to the sizer
930            ctrl = ValidatedTxtCtrl(panel,d,k,OKcontrol=self.ControlOKButton,
931                                    **kargs)
932            self.ValidatedControlsList.append(ctrl)
933            subSizer.Add(ctrl)
934            if i < len(postlbl): # label after TextCtrl, or put in a blank
935                subSizer.Add(wx.StaticText(panel,wx.ID_ANY,str(postlbl[i])))
936            else:
937                subSizer.Add((-1,-1))
938            if i < len(checkdictlst):
939                ch = G2CheckBox(panel,checklabel,checkdictlst[i],checkelemlst[i])
940                self.CheckControlsList.append(ch)
941                subSizer.Add(ch)                   
942            else:
943                subSizer.Add((-1,-1))
944        # finish up ScrolledPanel
945        panel.SetSizer(subSizer)
946        panel.SetAutoLayout(1)
947        panel.SetupScrolling()
948        # patch for wx 2.9 on Mac
949        i,j= wx.__version__.split('.')[0:2]
950        if int(i)+int(j)/10. > 2.8 and 'wxOSX' in wx.PlatformInfo:
951            panel.SetMinSize((subSizer.GetSize()[0]+30,panel.GetSize()[1]))       
952        mainSizer.Add(panel,1, wx.ALL|wx.EXPAND,1)
953
954        # Sizer for OK/Close buttons. N.B. on Close changes are discarded
955        # by restoring the initial values
956        btnsizer = wx.BoxSizer(wx.HORIZONTAL)
957        btnsizer.Add(self.OKbtn)
958        btn = wx.Button(self, wx.ID_CLOSE,"Cancel") 
959        btn.Bind(wx.EVT_BUTTON,self._onClose)
960        btnsizer.Add(btn)
961        mainSizer.Add(btnsizer, 0, wx.ALIGN_CENTER|wx.ALL, 5)
962        # size out the window. Set it to be enlarged but not made smaller
963        self.SetSizer(mainSizer)
964        mainSizer.Fit(self)
965        self.SetMinSize(self.GetSize())
966
967    def _OnCopyButton(self,event):
968        'Implements the copy down functionality'
969        but = event.GetEventObject()
970        n = self.ButtonIndex.get(but)
971        if n is None: return
972        for i,(d,k,ctrl) in enumerate(zip(self.dictlst,self.elemlst,self.ValidatedControlsList)):
973            if i < n: continue
974            if i == n:
975                val = d[k]
976                continue
977            d[k] = val
978            ctrl.SetValue(val)
979        for i in range(len(self.checkdictlst)):
980            if i < n: continue
981            self.checkdictlst[i][self.checkelemlst[i]] = self.checkdictlst[n][self.checkelemlst[n]]
982            self.CheckControlsList[i].SetValue(self.checkdictlst[i][self.checkelemlst[i]])
983    def _onClose(self,event):
984        'Used on Cancel: Restore original values & close the window'
985        for d,i,v in zip(self.dictlst,self.elemlst,self.orig):
986            d[i] = v
987        for i in range(len(self.checkdictlst)):
988            self.checkdictlst[i][self.checkelemlst[i]] = self.StartCheckValues[i]
989        self.EndModal(wx.ID_CANCEL)
990       
991    def ControlOKButton(self,setvalue):
992        '''Enable or Disable the OK button for the dialog. Note that this is
993        passed into the ValidatedTxtCtrl for use by validators.
994
995        :param bool setvalue: if True, all entries in the dialog are
996          checked for validity. if False then the OK button is disabled.
997
998        '''
999        if setvalue: # turn button on, do only if all controls show as valid
1000            for ctrl in self.ValidatedControlsList:
1001                if ctrl.invalid:
1002                    self.OKbtn.Disable()
1003                    return
1004            else:
1005                self.OKbtn.Enable()
1006        else:
1007            self.OKbtn.Disable()
1008
1009################################################################################
1010####
1011################################################################################
1012def SelectEdit1Var(G2frame,array,labelLst,elemKeysLst,dspLst,refFlgElem):
1013    '''Select a variable from a list, then edit it and select histograms
1014    to copy it to.
1015
1016    :param wx.Frame G2frame: main GSAS-II frame
1017    :param dict array: the array (dict or list) where values to be edited are kept
1018    :param list labelLst: labels for each data item
1019    :param list elemKeysLst: a list of lists of keys needed to be applied (see below)
1020      to obtain the value of each parameter
1021    :param list dspLst: list list of digits to be displayed (10,4) is 10 digits
1022      with 4 decimal places. Can be None.
1023    :param list refFlgElem: a list of lists of keys needed to be applied (see below)
1024      to obtain the refine flag for each parameter or None if the parameter
1025      does not have refine flag.
1026
1027    Example::
1028      array = data
1029      labelLst = ['v1','v2']
1030      elemKeysLst = [['v1'], ['v2',0]]
1031      refFlgElem = [None, ['v2',1]]
1032
1033     * The value for v1 will be in data['v1'] and this cannot be refined while,
1034     * The value for v2 will be in data['v2'][0] and its refinement flag is data['v2'][1]
1035    '''
1036    def unkey(dct,keylist):
1037        '''dive into a nested set of dicts/lists applying keys in keylist
1038        consecutively
1039        '''
1040        d = dct
1041        for k in keylist:
1042            d = d[k]
1043        return d
1044
1045    def OnChoice(event):
1046        'Respond when a parameter is selected in the Choice box'
1047        valSizer.DeleteWindows()
1048        lbl = event.GetString()
1049        copyopts['currentsel'] = lbl
1050        i = labelLst.index(lbl)
1051        OKbtn.Enable(True)
1052        ch.SetLabel(lbl)
1053        args = {}
1054        if dspLst[i]:
1055            args = {'nDig':dspLst[i]}
1056        Val = ValidatedTxtCtrl(
1057            dlg,
1058            unkey(array,elemKeysLst[i][:-1]),
1059            elemKeysLst[i][-1],
1060            **args)
1061        copyopts['startvalue'] = unkey(array,elemKeysLst[i])
1062        #unkey(array,elemKeysLst[i][:-1])[elemKeysLst[i][-1]] =
1063        valSizer.Add(Val,0,wx.LEFT,5)
1064        dlg.SendSizeEvent()
1065       
1066    # SelectEdit1Var execution begins here
1067    saveArray = copy.deepcopy(array) # keep original values
1068    TreeItemType = G2frame.PatternTree.GetItemText(G2frame.PickId)
1069    copyopts = {'InTable':False,"startvalue":None,'currentsel':None}       
1070    hst = G2frame.PatternTree.GetItemText(G2frame.PatternId)
1071    histList = G2pdG.GetHistsLikeSelected(G2frame)
1072    if not histList:
1073        G2frame.ErrorDialog('No match','No histograms match '+hst,G2frame.dataFrame)
1074        return
1075    dlg = wx.Dialog(G2frame.dataDisplay,wx.ID_ANY,'Set a parameter value',
1076        style=wx.DEFAULT_DIALOG_STYLE|wx.RESIZE_BORDER)
1077    mainSizer = wx.BoxSizer(wx.VERTICAL)
1078    mainSizer.Add((5,5))
1079    subSizer = wx.BoxSizer(wx.HORIZONTAL)
1080    subSizer.Add((-1,-1),1,wx.EXPAND)
1081    subSizer.Add(wx.StaticText(dlg,wx.ID_ANY,'Select a parameter and set a new value'))
1082    subSizer.Add((-1,-1),1,wx.EXPAND)
1083    mainSizer.Add(subSizer,0,wx.EXPAND,0)
1084    mainSizer.Add((0,10))
1085
1086    subSizer = wx.FlexGridSizer(0,2,5,0)
1087    subSizer.Add(wx.StaticText(dlg,wx.ID_ANY,'Parameter: '))
1088    ch = wx.Choice(dlg, wx.ID_ANY, choices = sorted(labelLst))
1089    ch.SetSelection(-1)
1090    ch.Bind(wx.EVT_CHOICE, OnChoice)
1091    subSizer.Add(ch)
1092    subSizer.Add(wx.StaticText(dlg,wx.ID_ANY,'Value: '))
1093    valSizer = wx.BoxSizer(wx.HORIZONTAL)
1094    subSizer.Add(valSizer)
1095    mainSizer.Add(subSizer)
1096
1097    mainSizer.Add((-1,20))
1098    subSizer = wx.BoxSizer(wx.HORIZONTAL)
1099    subSizer.Add(G2CheckBox(dlg, 'Edit in table ', copyopts, 'InTable'))
1100    mainSizer.Add(subSizer)
1101
1102    btnsizer = wx.StdDialogButtonSizer()
1103    OKbtn = wx.Button(dlg, wx.ID_OK,'Continue')
1104    OKbtn.Enable(False)
1105    OKbtn.SetDefault()
1106    OKbtn.Bind(wx.EVT_BUTTON,lambda event: dlg.EndModal(wx.ID_OK))
1107    btnsizer.AddButton(OKbtn)
1108    btn = wx.Button(dlg, wx.ID_CANCEL)
1109    btnsizer.AddButton(btn)
1110    btnsizer.Realize()
1111    mainSizer.Add((-1,5),1,wx.EXPAND,1)
1112    mainSizer.Add(btnsizer,0,wx.ALIGN_CENTER,0)
1113    mainSizer.Add((-1,10))
1114
1115    dlg.SetSizer(mainSizer)
1116    dlg.CenterOnParent()
1117    if dlg.ShowModal() != wx.ID_OK:
1118        array.update(saveArray)
1119        dlg.Destroy()
1120        return
1121    dlg.Destroy()
1122
1123    copyList = []
1124    lbl = copyopts['currentsel']
1125    dlg = G2MultiChoiceDialog(
1126        G2frame.dataFrame, 
1127        'Copy parameter '+lbl+' from\n'+hst,
1128        'Copy parameters', histList)
1129    dlg.CenterOnParent()
1130    try:
1131        if dlg.ShowModal() == wx.ID_OK:
1132            for i in dlg.GetSelections(): 
1133                copyList.append(histList[i])
1134        else:
1135            # reset the parameter since cancel was pressed
1136            array.update(saveArray)
1137            return
1138    finally:
1139        dlg.Destroy()
1140
1141    prelbl = [hst]
1142    i = labelLst.index(lbl)
1143    keyLst = elemKeysLst[i]
1144    refkeys = refFlgElem[i]
1145    dictlst = [unkey(array,keyLst[:-1])]
1146    if refkeys is not None:
1147        refdictlst = [unkey(array,refkeys[:-1])]
1148    else:
1149        refdictlst = None
1150    Id = GetPatternTreeItemId(G2frame,G2frame.root,hst)
1151    hstData = G2frame.PatternTree.GetItemPyData(GetPatternTreeItemId(G2frame,Id,'Instrument Parameters'))[0]
1152    for h in copyList:
1153        Id = GetPatternTreeItemId(G2frame,G2frame.root,h)
1154        instData = G2frame.PatternTree.GetItemPyData(GetPatternTreeItemId(G2frame,Id,'Instrument Parameters'))[0]
1155        if len(hstData) != len(instData) or hstData['Type'][0] != instData['Type'][0]:  #don't mix data types or lam & lam1/lam2 parms!
1156            print h+' not copied - instrument parameters not commensurate'
1157            continue
1158        hData = G2frame.PatternTree.GetItemPyData(GetPatternTreeItemId(G2frame,Id,TreeItemType))
1159        if TreeItemType == 'Instrument Parameters':
1160            hData = hData[0]
1161        #copy the value if it is changed or we will not edit in a table
1162        valNow = unkey(array,keyLst)
1163        if copyopts['startvalue'] != valNow or not copyopts['InTable']:
1164            unkey(hData,keyLst[:-1])[keyLst[-1]] = valNow
1165        prelbl += [h]
1166        dictlst += [unkey(hData,keyLst[:-1])]
1167        if refdictlst is not None:
1168            refdictlst += [unkey(hData,refkeys[:-1])]
1169    if refdictlst is None:
1170        args = {}
1171    else:
1172        args = {'checkdictlst':refdictlst,
1173                'checkelemlst':len(dictlst)*[refkeys[-1]],
1174                'checklabel':'Refine?'}
1175    if copyopts['InTable']:
1176        dlg = ScrolledMultiEditor(
1177            G2frame.dataDisplay,dictlst,
1178            len(dictlst)*[keyLst[-1]],prelbl,
1179            header='Editing parameter '+lbl,
1180            CopyButton=True,**args)
1181        dlg.CenterOnParent()
1182        if dlg.ShowModal() != wx.ID_OK:
1183            array.update(saveArray)
1184        dlg.Destroy()
1185
1186################################################################################
1187#### Custom checkbox that saves values into dict/list as used
1188################################################################################
1189class G2CheckBox(wx.CheckBox):
1190    '''A customized version of a CheckBox that automatically initializes
1191    the control to a supplied list or dict entry and updates that
1192    entry as the widget is used.
1193
1194    :param wx.Panel parent: name of panel or frame that will be
1195      the parent to the widget. Can be None.
1196    :param str label: text to put on check button
1197    :param dict/list loc: the dict or list with the initial value to be
1198      placed in the CheckBox.
1199    :param int/str key: the dict key or the list index for the value to be
1200      edited by the CheckBox. The ``loc[key]`` element must exist.
1201      The CheckBox will be initialized from this value.
1202      If the value is anything other that True (or 1), it will be taken as
1203      False.
1204    '''
1205    def __init__(self,parent,label,loc,key):
1206        wx.CheckBox.__init__(self,parent,id=wx.ID_ANY,label=label)
1207        self.loc = loc
1208        self.key = key
1209        self.SetValue(self.loc[self.key]==True)
1210        self.Bind(wx.EVT_CHECKBOX, self._OnCheckBox)
1211    def _OnCheckBox(self,event):
1212        self.loc[self.key] = self.GetValue()
1213        log.LogVarChange(self.loc,self.key)
1214
1215################################################################################
1216####
1217################################################################################
1218class PickTwoDialog(wx.Dialog):
1219    '''This does not seem to be in use
1220    '''
1221    def __init__(self,parent,title,prompt,names,choices):
1222        wx.Dialog.__init__(self,parent,-1,title, 
1223            pos=wx.DefaultPosition,style=wx.DEFAULT_DIALOG_STYLE)
1224        self.panel = wx.Panel(self)         #just a dummy - gets destroyed in Draw!
1225        self.prompt = prompt
1226        self.choices = choices
1227        self.names = names
1228        self.Draw()
1229
1230    def Draw(self):
1231        Indx = {}
1232       
1233        def OnSelection(event):
1234            Obj = event.GetEventObject()
1235            id = Indx[Obj.GetId()]
1236            self.choices[id] = Obj.GetValue().encode()  #to avoid Unicode versions
1237            self.Draw()
1238           
1239        self.panel.DestroyChildren()
1240        self.panel.Destroy()
1241        self.panel = wx.Panel(self)
1242        mainSizer = wx.BoxSizer(wx.VERTICAL)
1243        mainSizer.Add(wx.StaticText(self.panel,-1,self.prompt),0,wx.ALIGN_CENTER)
1244        for isel,name in enumerate(self.choices):
1245            lineSizer = wx.BoxSizer(wx.HORIZONTAL)
1246            lineSizer.Add(wx.StaticText(self.panel,-1,'Reference atom '+str(isel+1)),0,wx.ALIGN_CENTER)
1247            nameList = self.names[:]
1248            if isel:
1249                if self.choices[0] in nameList:
1250                    nameList.remove(self.choices[0])
1251            choice = wx.ComboBox(self.panel,-1,value=name,choices=nameList,
1252                style=wx.CB_READONLY|wx.CB_DROPDOWN)
1253            Indx[choice.GetId()] = isel
1254            choice.Bind(wx.EVT_COMBOBOX, OnSelection)
1255            lineSizer.Add(choice,0,WACV)
1256            mainSizer.Add(lineSizer)
1257        OkBtn = wx.Button(self.panel,-1,"Ok")
1258        OkBtn.Bind(wx.EVT_BUTTON, self.OnOk)
1259        CancelBtn = wx.Button(self.panel,-1,'Cancel')
1260        CancelBtn.Bind(wx.EVT_BUTTON, self.OnCancel)
1261        btnSizer = wx.BoxSizer(wx.HORIZONTAL)
1262        btnSizer.Add((20,20),1)
1263        btnSizer.Add(OkBtn)
1264        btnSizer.Add(CancelBtn)
1265        btnSizer.Add((20,20),1)
1266        mainSizer.Add(btnSizer,0,wx.EXPAND|wx.BOTTOM|wx.TOP, 10)
1267        self.panel.SetSizer(mainSizer)
1268        self.panel.Fit()
1269        self.Fit()
1270       
1271    def GetSelection(self):
1272        return self.choices
1273
1274    def OnOk(self,event):
1275        parent = self.GetParent()
1276        parent.Raise()
1277        self.EndModal(wx.ID_OK)             
1278       
1279    def OnCancel(self,event):
1280        parent = self.GetParent()
1281        parent.Raise()
1282        self.EndModal(wx.ID_CANCEL)
1283
1284################################################################################
1285#### Column-order selection
1286################################################################################
1287
1288def GetItemOrder(parent,keylist,vallookup,posdict):
1289    '''Creates a panel where items can be ordered into columns
1290   
1291    :param list keylist: is a list of keys for column assignments
1292    :param dict vallookup: is a dict keyed by names in keylist where each item is a dict.
1293       Each inner dict contains variable names as keys and their associated values
1294    :param dict posdict: is a dict keyed by names in keylist where each item is a dict.
1295       Each inner dict contains column numbers as keys and their associated
1296       variable name as a value. This is used for both input and output.
1297       
1298    '''
1299    dlg = wx.Dialog(parent,style=wx.DEFAULT_DIALOG_STYLE|wx.RESIZE_BORDER)
1300    sizer = wx.BoxSizer(wx.VERTICAL)
1301    spanel = OrderBox(dlg,keylist,vallookup,posdict)
1302    spanel.Fit()
1303    sizer.Add(spanel,1,wx.EXPAND)
1304    btnsizer = wx.StdDialogButtonSizer()
1305    btn = wx.Button(dlg, wx.ID_OK)
1306    btn.SetDefault()
1307    btnsizer.AddButton(btn)
1308    #btn = wx.Button(dlg, wx.ID_CANCEL)
1309    #btnsizer.AddButton(btn)
1310    btnsizer.Realize()
1311    sizer.Add(btnsizer, 0, wx.ALIGN_CENTER_VERTICAL|wx.EXPAND|wx.ALL, 5)
1312    dlg.SetSizer(sizer)
1313    sizer.Fit(dlg)
1314    val = dlg.ShowModal()
1315
1316################################################################################
1317####
1318################################################################################
1319class OrderBox(wxscroll.ScrolledPanel):
1320    '''Creates a panel with scrollbars where items can be ordered into columns
1321   
1322    :param list keylist: is a list of keys for column assignments
1323    :param dict vallookup: is a dict keyed by names in keylist where each item is a dict.
1324      Each inner dict contains variable names as keys and their associated values
1325    :param dict posdict: is a dict keyed by names in keylist where each item is a dict.
1326      Each inner dict contains column numbers as keys and their associated
1327      variable name as a value. This is used for both input and output.
1328     
1329    '''
1330    def __init__(self,parent,keylist,vallookup,posdict,*arg,**kw):
1331        self.keylist = keylist
1332        self.vallookup = vallookup
1333        self.posdict = posdict
1334        self.maxcol = 0
1335        for nam in keylist:
1336            posdict = self.posdict[nam]
1337            if posdict.keys():
1338                self.maxcol = max(self.maxcol, max(posdict))
1339        wxscroll.ScrolledPanel.__init__(self,parent,wx.ID_ANY,*arg,**kw)
1340        self.GBsizer = wx.GridBagSizer(4,4)
1341        self.SetBackgroundColour(WHITE)
1342        self.SetSizer(self.GBsizer)
1343        colList = [str(i) for i in range(self.maxcol+2)]
1344        for i in range(self.maxcol+1):
1345            wid = wx.StaticText(self,wx.ID_ANY,str(i),style=wx.ALIGN_CENTER)
1346            wid.SetBackgroundColour(DULL_YELLOW)
1347            wid.SetMinSize((50,-1))
1348            self.GBsizer.Add(wid,(0,i),flag=wx.ALIGN_CENTER|wx.EXPAND)
1349        self.chceDict = {}
1350        for row,nam in enumerate(self.keylist):
1351            posdict = self.posdict[nam]
1352            for col in posdict:
1353                lbl = posdict[col]
1354                pnl = wx.Panel(self,wx.ID_ANY)
1355                pnl.SetBackgroundColour(VERY_LIGHT_GREY)
1356                insize = wx.BoxSizer(wx.VERTICAL)
1357                wid = wx.Choice(pnl,wx.ID_ANY,choices=colList)
1358                insize.Add(wid,0,wx.EXPAND|wx.BOTTOM,3)
1359                wid.SetSelection(col)
1360                self.chceDict[wid] = (row,col)
1361                wid.Bind(wx.EVT_CHOICE,self.OnChoice)
1362                wid = wx.StaticText(pnl,wx.ID_ANY,lbl)
1363                insize.Add(wid,0,flag=wx.EXPAND)
1364                val = G2py3.FormatSigFigs(self.vallookup[nam][lbl],maxdigits=8)
1365                wid = wx.StaticText(pnl,wx.ID_ANY,'('+val+')')
1366                insize.Add(wid,0,flag=wx.EXPAND)
1367                pnl.SetSizer(insize)
1368                self.GBsizer.Add(pnl,(row+1,col),flag=wx.EXPAND)
1369        self.SetAutoLayout(1)
1370        self.SetupScrolling()
1371        self.SetMinSize((
1372            min(700,self.GBsizer.GetSize()[0]),
1373            self.GBsizer.GetSize()[1]+20))
1374    def OnChoice(self,event):
1375        '''Called when a column is assigned to a variable
1376        '''
1377        row,col = self.chceDict[event.EventObject] # which variable was this?
1378        newcol = event.Selection # where will it be moved?
1379        if newcol == col:
1380            return # no change: nothing to do!
1381        prevmaxcol = self.maxcol # save current table size
1382        key = self.keylist[row] # get the key for the current row
1383        lbl = self.posdict[key][col] # selected variable name
1384        lbl1 = self.posdict[key].get(col+1,'') # next variable name, if any
1385        # if a posXXX variable is selected, and the next variable is posXXX, move them together
1386        repeat = 1
1387        if lbl[:3] == 'pos' and lbl1[:3] == 'int' and lbl[3:] == lbl1[3:]:
1388            repeat = 2
1389        for i in range(repeat): # process the posXXX and then the intXXX (or a single variable)
1390            col += i
1391            newcol += i
1392            if newcol in self.posdict[key]:
1393                # find first non-blank after newcol
1394                for mtcol in range(newcol+1,self.maxcol+2):
1395                    if mtcol not in self.posdict[key]: break
1396                l1 = range(mtcol,newcol,-1)+[newcol]
1397                l = range(mtcol-1,newcol-1,-1)+[col]
1398            else:
1399                l1 = [newcol]
1400                l = [col]
1401            # move all of the items, starting from the last column
1402            for newcol,col in zip(l1,l):
1403                #print 'moving',col,'to',newcol
1404                self.posdict[key][newcol] = self.posdict[key][col]
1405                del self.posdict[key][col]
1406                self.maxcol = max(self.maxcol,newcol)
1407                obj = self.GBsizer.FindItemAtPosition((row+1,col))
1408                self.GBsizer.SetItemPosition(obj.GetWindow(),(row+1,newcol))
1409                for wid in obj.GetWindow().Children:
1410                    if wid in self.chceDict:
1411                        self.chceDict[wid] = (row,newcol)
1412                        wid.SetSelection(self.chceDict[wid][1])
1413        # has the table gotten larger? If so we need new column heading(s)
1414        if prevmaxcol != self.maxcol:
1415            for i in range(prevmaxcol+1,self.maxcol+1):
1416                wid = wx.StaticText(self,wx.ID_ANY,str(i),style=wx.ALIGN_CENTER)
1417                wid.SetBackgroundColour(DULL_YELLOW)
1418                wid.SetMinSize((50,-1))
1419                self.GBsizer.Add(wid,(0,i),flag=wx.ALIGN_CENTER|wx.EXPAND)
1420            colList = [str(i) for i in range(self.maxcol+2)]
1421            for wid in self.chceDict:
1422                wid.SetItems(colList)
1423                wid.SetSelection(self.chceDict[wid][1])
1424        self.GBsizer.Layout()
1425        self.FitInside()
1426
1427################################################################################
1428#### Help support routines
1429################################################################################
1430################################################################################
1431class MyHelp(wx.Menu):
1432    '''
1433    A class that creates the contents of a help menu.
1434    The menu will start with two entries:
1435
1436    * 'Help on <helpType>': where helpType is a reference to an HTML page to
1437      be opened
1438    * About: opens an About dialog using OnHelpAbout. N.B. on the Mac this
1439      gets moved to the App menu to be consistent with Apple style.
1440
1441    NOTE: for this to work properly with respect to system menus, the title
1442    for the menu must be &Help, or it will not be processed properly:
1443
1444    ::
1445
1446       menu.Append(menu=MyHelp(self,...),title="&Help")
1447
1448    '''
1449    def __init__(self,frame,helpType=None,helpLbl=None,morehelpitems=[],title=''):
1450        wx.Menu.__init__(self,title)
1451        self.HelpById = {}
1452        self.frame = frame
1453        self.Append(help='', id=wx.ID_ABOUT, kind=wx.ITEM_NORMAL,
1454            text='&About GSAS-II')
1455        frame.Bind(wx.EVT_MENU, self.OnHelpAbout, id=wx.ID_ABOUT)
1456        if GSASIIpath.whichsvn():
1457            helpobj = self.Append(
1458                help='', id=wx.ID_ANY, kind=wx.ITEM_NORMAL,
1459                text='&Check for updates')
1460            frame.Bind(wx.EVT_MENU, self.OnCheckUpdates, helpobj)
1461            helpobj = self.Append(
1462                help='', id=wx.ID_ANY, kind=wx.ITEM_NORMAL,
1463                text='&Regress to an old GSAS-II version')
1464            frame.Bind(wx.EVT_MENU, self.OnSelectVersion, helpobj)
1465        for lbl,indx in morehelpitems:
1466            helpobj = self.Append(text=lbl,
1467                id=wx.ID_ANY, kind=wx.ITEM_NORMAL)
1468            frame.Bind(wx.EVT_MENU, self.OnHelpById, helpobj)
1469            self.HelpById[helpobj.GetId()] = indx
1470        # add a help item only when helpType is specified
1471        if helpType is not None:
1472            self.AppendSeparator()
1473            if helpLbl is None: helpLbl = helpType
1474            helpobj = self.Append(text='Help on '+helpLbl,
1475                                  id=wx.ID_ANY, kind=wx.ITEM_NORMAL)
1476            frame.Bind(wx.EVT_MENU, self.OnHelpById, helpobj)
1477            self.HelpById[helpobj.GetId()] = helpType
1478       
1479    def OnHelpById(self,event):
1480        '''Called when Help on... is pressed in a menu. Brings up
1481        a web page for documentation.
1482        '''
1483        helpType = self.HelpById.get(event.GetId())
1484        if helpType is None:
1485            print 'Error: help lookup failed!',event.GetEventObject()
1486            print 'id=',event.GetId()
1487        elif helpType == 'OldTutorials': # this will go away
1488            self.frame.Tutorials = True
1489            ShowHelp(helpType,self.frame)
1490        elif helpType == 'Tutorials': 
1491            dlg = OpenTutorial(self.frame)
1492            if dlg.ShowModal() == wx.ID_OK:
1493                self.frame.Tutorials = True
1494            dlg.Destroy()
1495            return
1496        else:
1497            ShowHelp(helpType,self.frame)
1498
1499    def OnHelpAbout(self, event):
1500        "Display an 'About GSAS-II' box"
1501        import GSASII
1502        info = wx.AboutDialogInfo()
1503        info.Name = 'GSAS-II'
1504        ver = GSASIIpath.svnGetRev()
1505        if ver: 
1506            info.Version = 'Revision '+str(ver)+' (svn), version '+GSASII.__version__
1507        else:
1508            info.Version = 'Revision '+str(GSASIIpath.GetVersionNumber())+' (.py files), version '+GSASII.__version__
1509        #info.Developers = ['Robert B. Von Dreele','Brian H. Toby']
1510        info.Copyright = ('(c) ' + time.strftime('%Y') +
1511''' Argonne National Laboratory
1512This product includes software developed
1513by the UChicago Argonne, LLC, as
1514Operator of Argonne National Laboratory.''')
1515        info.Description = '''General Structure Analysis System-II (GSAS-II)
1516Robert B. Von Dreele and Brian H. Toby
1517
1518Please cite as:
1519B.H. Toby & R.B. Von Dreele, J. Appl. Cryst. 46, 544-549 (2013) '''
1520
1521        info.WebSite = ("https://subversion.xray.aps.anl.gov/trac/pyGSAS","GSAS-II home page")
1522        wx.AboutBox(info)
1523
1524    def OnCheckUpdates(self,event):
1525        '''Check if the GSAS-II repository has an update for the current source files
1526        and perform that update if requested.
1527        '''
1528        if not GSASIIpath.whichsvn():
1529            dlg = wx.MessageDialog(self.frame,
1530                                   'No Subversion','Cannot update GSAS-II because subversion (svn) was not found.',
1531                                   wx.OK)
1532            dlg.ShowModal()
1533            dlg.Destroy()
1534            return
1535        wx.BeginBusyCursor()
1536        local = GSASIIpath.svnGetRev()
1537        if local is None: 
1538            wx.EndBusyCursor()
1539            dlg = wx.MessageDialog(self.frame,
1540                                   'Unable to run subversion on the GSAS-II current directory. Is GSAS-II installed correctly?',
1541                                   'Subversion error',
1542                                   wx.OK)
1543            dlg.ShowModal()
1544            dlg.Destroy()
1545            return
1546        print 'Installed GSAS-II version: '+local
1547        repos = GSASIIpath.svnGetRev(local=False)
1548        wx.EndBusyCursor()
1549        if repos is None: 
1550            dlg = wx.MessageDialog(self.frame,
1551                                   'Unable to access the GSAS-II server. Is this computer on the internet?',
1552                                   'Server unavailable',
1553                                   wx.OK)
1554            dlg.ShowModal()
1555            dlg.Destroy()
1556            return
1557        print 'GSAS-II version on server: '+repos
1558        if local == repos:
1559            dlg = wx.MessageDialog(self.frame,
1560                                   'GSAS-II is up-to-date. Version '+local+' is already loaded.',
1561                                   'GSAS-II Up-to-date',
1562                                   wx.OK)
1563            dlg.ShowModal()
1564            dlg.Destroy()
1565            return
1566        mods = GSASIIpath.svnFindLocalChanges()
1567        if mods:
1568            dlg = wx.MessageDialog(self.frame,
1569                                   'You have version '+local+
1570                                   ' of GSAS-II installed, but the current version is '+repos+
1571                                   '. However, '+str(len(mods))+
1572                                   ' file(s) on your local computer have been modified.'
1573                                   ' Updating will attempt to merge your local changes with '
1574                                   'the latest GSAS-II version, but if '
1575                                   'conflicts arise, local changes will be '
1576                                   'discarded. It is also possible that the '
1577                                   'local changes my prevent GSAS-II from running. '
1578                                   'Press OK to start an update if this is acceptable:',
1579                                   'Local GSAS-II Mods',
1580                                   wx.OK|wx.CANCEL)
1581            if dlg.ShowModal() != wx.ID_OK:
1582                dlg.Destroy()
1583                return
1584            else:
1585                dlg.Destroy()
1586        else:
1587            dlg = wx.MessageDialog(self.frame,
1588                                   'You have version '+local+
1589                                   ' of GSAS-II installed, but the current version is '+repos+
1590                                   '. Press OK to start an update:',
1591                                   'GSAS-II Updates',
1592                                   wx.OK|wx.CANCEL)
1593            if dlg.ShowModal() != wx.ID_OK:
1594                dlg.Destroy()
1595                return
1596            dlg.Destroy()
1597        print 'start updates'
1598        dlg = wx.MessageDialog(self.frame,
1599                               'Your project will now be saved, GSAS-II will exit and an update '
1600                               'will be performed and GSAS-II will restart. Press Cancel to '
1601                               'abort the update',
1602                               'Start update?',
1603                               wx.OK|wx.CANCEL)
1604        if dlg.ShowModal() != wx.ID_OK:
1605            dlg.Destroy()
1606            return
1607        dlg.Destroy()
1608        self.frame.OnFileSave(event)
1609        GSASIIpath.svnUpdateProcess(projectfile=self.frame.GSASprojectfile)
1610        return
1611
1612    def OnSelectVersion(self,event):
1613        '''Allow the user to select a specific version of GSAS-II
1614        '''
1615        if not GSASIIpath.whichsvn():
1616            dlg = wx.MessageDialog(self,'No Subversion','Cannot update GSAS-II because subversion (svn) '+
1617                                   'was not found.'
1618                                   ,wx.OK)
1619            dlg.ShowModal()
1620            return
1621        local = GSASIIpath.svnGetRev()
1622        if local is None: 
1623            dlg = wx.MessageDialog(self.frame,
1624                                   'Unable to run subversion on the GSAS-II current directory. Is GSAS-II installed correctly?',
1625                                   'Subversion error',
1626                                   wx.OK)
1627            dlg.ShowModal()
1628            return
1629        mods = GSASIIpath.svnFindLocalChanges()
1630        if mods:
1631            dlg = wx.MessageDialog(self.frame,
1632                                   'You have version '+local+
1633                                   ' of GSAS-II installed'
1634                                   '. However, '+str(len(mods))+
1635                                   ' file(s) on your local computer have been modified.'
1636                                   ' Downdating will attempt to merge your local changes with '
1637                                   'the selected GSAS-II version. '
1638                                   'Downdating is not encouraged because '
1639                                   'if merging is not possible, your local changes will be '
1640                                   'discarded. It is also possible that the '
1641                                   'local changes my prevent GSAS-II from running. '
1642                                   'Press OK to continue anyway.',
1643                                   'Local GSAS-II Mods',
1644                                   wx.OK|wx.CANCEL)
1645            if dlg.ShowModal() != wx.ID_OK:
1646                dlg.Destroy()
1647                return
1648            dlg.Destroy()
1649        dlg = downdate(parent=self.frame)
1650        if dlg.ShowModal() == wx.ID_OK:
1651            ver = dlg.getVersion()
1652        else:
1653            dlg.Destroy()
1654            return
1655        dlg.Destroy()
1656        print('start regress to '+str(ver))
1657        GSASIIpath.svnUpdateProcess(
1658            projectfile=self.frame.GSASprojectfile,
1659            version=str(ver)
1660            )
1661        self.frame.OnFileSave(event)
1662        return
1663
1664################################################################################
1665class AddHelp(wx.Menu):
1666    '''For the Mac: creates an entry to the help menu of type
1667    'Help on <helpType>': where helpType is a reference to an HTML page to
1668    be opened.
1669
1670    NOTE: when appending this menu (menu.Append) be sure to set the title to
1671    '&Help' so that wx handles it correctly.
1672    '''
1673    def __init__(self,frame,helpType,helpLbl=None,title=''):
1674        wx.Menu.__init__(self,title)
1675        self.frame = frame
1676        if helpLbl is None: helpLbl = helpType
1677        # add a help item only when helpType is specified
1678        helpobj = self.Append(text='Help on '+helpLbl,
1679                              id=wx.ID_ANY, kind=wx.ITEM_NORMAL)
1680        frame.Bind(wx.EVT_MENU, self.OnHelpById, helpobj)
1681        self.HelpById = helpType
1682       
1683    def OnHelpById(self,event):
1684        '''Called when Help on... is pressed in a menu. Brings up
1685        a web page for documentation.
1686        '''
1687        ShowHelp(self.HelpById,self.frame)
1688
1689################################################################################
1690class HelpButton(wx.Button):
1691    '''Create a help button that displays help information.
1692    The text is displayed in a modal message window.
1693
1694    TODO: it might be nice if it were non-modal: e.g. it stays around until
1695    the parent is deleted or the user closes it, but this did not work for
1696    me.
1697
1698    :param parent: the panel which will be the parent of the button
1699    :param str msg: the help text to be displayed
1700    '''
1701    def __init__(self,parent,msg):
1702        if sys.platform == "darwin": 
1703            wx.Button.__init__(self,parent,wx.ID_HELP)
1704        else:
1705            wx.Button.__init__(self,parent,wx.ID_ANY,'?',style=wx.BU_EXACTFIT)
1706        self.Bind(wx.EVT_BUTTON,self._onPress)
1707        self.msg=StripIndents(msg)
1708        self.parent = parent
1709    def _onClose(self,event):
1710        self.dlg.EndModal(wx.ID_CANCEL)
1711    def _onPress(self,event):
1712        'Respond to a button press by displaying the requested text'
1713        #dlg = wx.MessageDialog(self.parent,self.msg,'Help info',wx.OK)
1714        self.dlg = wx.Dialog(self.parent,wx.ID_ANY,'Help information', 
1715                        style=wx.DEFAULT_DIALOG_STYLE|wx.RESIZE_BORDER)
1716        #self.dlg.SetBackgroundColour(wx.WHITE)
1717        mainSizer = wx.BoxSizer(wx.VERTICAL)
1718        txt = wx.StaticText(self.dlg,wx.ID_ANY,self.msg)
1719        mainSizer.Add(txt,1,wx.ALL|wx.EXPAND,10)
1720        txt.SetBackgroundColour(wx.WHITE)
1721
1722        btnsizer = wx.BoxSizer(wx.HORIZONTAL)
1723        btn = wx.Button(self.dlg, wx.ID_CLOSE) 
1724        btn.Bind(wx.EVT_BUTTON,self._onClose)
1725        btnsizer.Add(btn)
1726        mainSizer.Add(btnsizer, 0, wx.ALIGN_CENTER|wx.ALL, 5)
1727        self.dlg.SetSizer(mainSizer)
1728        mainSizer.Fit(self.dlg)
1729        self.dlg.ShowModal()
1730        self.dlg.Destroy()
1731################################################################################
1732class MyHtmlPanel(wx.Panel):
1733    '''Defines a panel to display HTML help information, as an alternative to
1734    displaying help information in a web browser.
1735    '''
1736    def __init__(self, frame, id):
1737        self.frame = frame
1738        wx.Panel.__init__(self, frame, id)
1739        sizer = wx.BoxSizer(wx.VERTICAL)
1740        back = wx.Button(self, -1, "Back")
1741        back.Bind(wx.EVT_BUTTON, self.OnBack)
1742        self.htmlwin = G2HtmlWindow(self, id, size=(750,450))
1743        sizer.Add(self.htmlwin, 1,wx.EXPAND)
1744        sizer.Add(back, 0, wx.ALIGN_LEFT, 0)
1745        self.SetSizer(sizer)
1746        sizer.Fit(frame)       
1747        self.Bind(wx.EVT_SIZE,self.OnHelpSize)
1748    def OnHelpSize(self,event):         #does the job but weirdly!!
1749        anchor = self.htmlwin.GetOpenedAnchor()
1750        if anchor:           
1751            self.htmlwin.ScrollToAnchor(anchor)
1752            wx.CallAfter(self.htmlwin.ScrollToAnchor,anchor)
1753            event.Skip()
1754    def OnBack(self, event):
1755        self.htmlwin.HistoryBack()
1756    def LoadFile(self,file):
1757        pos = file.rfind('#')
1758        if pos != -1:
1759            helpfile = file[:pos]
1760            helpanchor = file[pos+1:]
1761        else:
1762            helpfile = file
1763            helpanchor = None
1764        self.htmlwin.LoadPage(helpfile)
1765        if helpanchor is not None:
1766            self.htmlwin.ScrollToAnchor(helpanchor)
1767            xs,ys = self.htmlwin.GetViewStart()
1768            self.htmlwin.Scroll(xs,ys-1)
1769################################################################################
1770class G2HtmlWindow(wx.html.HtmlWindow):
1771    '''Displays help information in a primitive HTML browser type window
1772    '''
1773    def __init__(self, parent, *args, **kwargs):
1774        self.parent = parent
1775        wx.html.HtmlWindow.__init__(self, parent, *args, **kwargs)
1776    def LoadPage(self, *args, **kwargs):
1777        wx.html.HtmlWindow.LoadPage(self, *args, **kwargs)
1778        self.TitlePage()
1779    def OnLinkClicked(self, *args, **kwargs):
1780        wx.html.HtmlWindow.OnLinkClicked(self, *args, **kwargs)
1781        xs,ys = self.GetViewStart()
1782        self.Scroll(xs,ys-1)
1783        self.TitlePage()
1784    def HistoryBack(self, *args, **kwargs):
1785        wx.html.HtmlWindow.HistoryBack(self, *args, **kwargs)
1786        self.TitlePage()
1787    def TitlePage(self):
1788        self.parent.frame.SetTitle(self.GetOpenedPage() + ' -- ' + 
1789            self.GetOpenedPageTitle())
1790
1791################################################################################
1792def StripIndents(msg):
1793    'Strip indentation from multiline strings'
1794    msg1 = msg.replace('\n ','\n')
1795    while msg != msg1:
1796        msg = msg1
1797        msg1 = msg.replace('\n ','\n')
1798    return msg.replace('\n\t','\n')
1799
1800def G2MessageBox(parent,msg,title='Error'):
1801    '''Simple code to display a error or warning message
1802    '''
1803    dlg = wx.MessageDialog(parent,StripIndents(msg), title, wx.OK)
1804    dlg.ShowModal()
1805    dlg.Destroy()
1806       
1807################################################################################
1808class downdate(wx.Dialog):
1809    '''Dialog to allow a user to select a version of GSAS-II to install
1810    '''
1811    def __init__(self,parent=None):
1812        style=wx.DEFAULT_DIALOG_STYLE | wx.RESIZE_BORDER
1813        wx.Dialog.__init__(self, parent, wx.ID_ANY, 'Select Version', style=style)
1814        pnl = wx.Panel(self)
1815        sizer = wx.BoxSizer(wx.VERTICAL)
1816        insver = GSASIIpath.svnGetRev(local=True)
1817        curver = int(GSASIIpath.svnGetRev(local=False))
1818        label = wx.StaticText(
1819            pnl,  wx.ID_ANY,
1820            'Select a specific GSAS-II version to install'
1821            )
1822        sizer.Add(label, 0, wx.ALIGN_CENTRE|wx.ALL, 5)
1823        sizer1 = wx.BoxSizer(wx.HORIZONTAL)
1824        sizer1.Add(
1825            wx.StaticText(pnl,  wx.ID_ANY,
1826                          'Currently installed version: '+str(insver)),
1827            0, wx.ALIGN_CENTRE|wx.ALL, 5)
1828        sizer.Add(sizer1)
1829        sizer1 = wx.BoxSizer(wx.HORIZONTAL)
1830        sizer1.Add(
1831            wx.StaticText(pnl,  wx.ID_ANY,
1832                          'Select GSAS-II version to install: '),
1833            0, wx.ALIGN_CENTRE|wx.ALL, 5)
1834        self.spin = wx.SpinCtrl(pnl, wx.ID_ANY,size=(150,-1))
1835        self.spin.SetRange(1, curver)
1836        self.spin.SetValue(curver)
1837        self.Bind(wx.EVT_SPINCTRL, self._onSpin, self.spin)
1838        self.Bind(wx.EVT_KILL_FOCUS, self._onSpin, self.spin)
1839        sizer1.Add(self.spin)
1840        sizer.Add(sizer1)
1841
1842        line = wx.StaticLine(pnl,-1, size=(-1,3), style=wx.LI_HORIZONTAL)
1843        sizer.Add(line, 0, wx.EXPAND|wx.ALIGN_CENTER|wx.ALL, 10)
1844
1845        self.text = wx.StaticText(pnl,  wx.ID_ANY, "")
1846        sizer.Add(self.text, 0, wx.ALIGN_LEFT|wx.EXPAND|wx.ALL, 5)
1847
1848        line = wx.StaticLine(pnl,-1, size=(-1,3), style=wx.LI_HORIZONTAL)
1849        sizer.Add(line, 0, wx.EXPAND|wx.ALIGN_CENTER|wx.ALL, 10)
1850        sizer.Add(
1851            wx.StaticText(
1852                pnl,  wx.ID_ANY,
1853                'If "Install" is pressed, your project will be saved;\n'
1854                'GSAS-II will exit; The specified version will be loaded\n'
1855                'and GSAS-II will restart. Press "Cancel" to abort.'),
1856            0, wx.EXPAND|wx.ALL, 10)
1857        btnsizer = wx.StdDialogButtonSizer()
1858        btn = wx.Button(pnl, wx.ID_OK, "Install")
1859        btn.SetDefault()
1860        btnsizer.AddButton(btn)
1861        btn = wx.Button(pnl, wx.ID_CANCEL)
1862        btnsizer.AddButton(btn)
1863        btnsizer.Realize()
1864        sizer.Add(btnsizer, 0, wx.ALIGN_CENTER|wx.ALL, 5)
1865        pnl.SetSizer(sizer)
1866        sizer.Fit(self)
1867        self.topsizer=sizer
1868        self.CenterOnParent()
1869        self._onSpin(None)
1870
1871    def _onSpin(self,event):
1872        'Called to load info about the selected version in the dialog'
1873        ver = self.spin.GetValue()
1874        d = GSASIIpath.svnGetLog(version=ver)
1875        date = d.get('date','?').split('T')[0]
1876        s = '(Version '+str(ver)+' created '+date
1877        s += ' by '+d.get('author','?')+')'
1878        msg = d.get('msg')
1879        if msg: s += '\n\nComment: '+msg
1880        self.text.SetLabel(s)
1881        self.topsizer.Fit(self)
1882
1883    def getVersion(self):
1884        'Get the version number in the dialog'
1885        return self.spin.GetValue()
1886################################################################################
1887#### Display Help information
1888################################################################################
1889# define some globals
1890htmlPanel = None
1891htmlFrame = None
1892htmlFirstUse = True
1893helpLocDict = {}
1894path2GSAS2 = os.path.dirname(os.path.realpath(__file__)) # save location of this file
1895def ShowHelp(helpType,frame):
1896    '''Called to bring up a web page for documentation.'''
1897    global htmlFirstUse
1898    # look up a definition for help info from dict
1899    helplink = helpLocDict.get(helpType)
1900    if helplink is None:
1901        # no defined link to use, create a default based on key
1902        helplink = 'gsasII.html#'+helpType.replace(' ','_')
1903    helplink = os.path.join(path2GSAS2,'help',helplink)
1904    # determine if a web browser or the internal viewer should be used for help info
1905    if GSASIIpath.GetConfigValue('Help_mode'):
1906        helpMode = GSASIIpath.GetConfigValue('Help_mode')
1907    else:
1908        helpMode = 'browser'
1909    if helpMode == 'internal':
1910        try:
1911            htmlPanel.LoadFile(helplink)
1912            htmlFrame.Raise()
1913        except:
1914            htmlFrame = wx.Frame(frame, -1, size=(610, 510))
1915            htmlFrame.Show(True)
1916            htmlFrame.SetTitle("HTML Window") # N.B. reset later in LoadFile
1917            htmlPanel = MyHtmlPanel(htmlFrame,-1)
1918            htmlPanel.LoadFile(helplink)
1919    else:
1920        pfx = "file://"
1921        if sys.platform.lower().startswith('win'):
1922            pfx = ''
1923        if htmlFirstUse:
1924            webbrowser.open_new(pfx+helplink)
1925            htmlFirstUse = False
1926        else:
1927            webbrowser.open(pfx+helplink, new=0, autoraise=True)
1928def ShowWebPage(URL,frame):
1929    '''Called to show a tutorial web page.
1930    '''
1931    global htmlFirstUse
1932    # determine if a web browser or the internal viewer should be used for help info
1933    if GSASIIpath.GetConfigValue('Help_mode'):
1934        helpMode = GSASIIpath.GetConfigValue('Help_mode')
1935    else:
1936        helpMode = 'browser'
1937    if helpMode == 'internal':
1938        try:
1939            htmlPanel.LoadFile(URL)
1940            htmlFrame.Raise()
1941        except:
1942            htmlFrame = wx.Frame(frame, -1, size=(610, 510))
1943            htmlFrame.Show(True)
1944            htmlFrame.SetTitle("HTML Window") # N.B. reset later in LoadFile
1945            htmlPanel = MyHtmlPanel(htmlFrame,-1)
1946            htmlPanel.LoadFile(URL)
1947    else:
1948        if URL.startswith('http'): 
1949            pfx = ''
1950        elif sys.platform.lower().startswith('win'):
1951            pfx = ''
1952        else:
1953            pfx = "file://"
1954        if htmlFirstUse:
1955            webbrowser.open_new(pfx+URL)
1956            htmlFirstUse = False
1957        else:
1958            webbrowser.open(pfx+URL, new=0, autoraise=True)
1959################################################################################
1960#### Tutorials selector
1961################################################################################
1962G2BaseURL = "https://subversion.xray.aps.anl.gov/pyGSAS"
1963# N.B. tutorialCatalog is generated by routine catalog.py, which also generates the appropriate
1964# empty directories (.../MT/* .../trunk/GSASII/* *=[help,Exercises])
1965tutorialCatalog = (
1966    # tutorial dir,      exercise dir,      web page file name                                title for page
1967
1968    ['StartingGSASII', 'StartingGSASII', 'Starting GSAS.htm',
1969       'Starting GSAS-II'],
1970       
1971    ['FitPeaks', 'FitPeaks', 'Fit Peaks.htm',
1972       'Fitting individual peaks & autoindexing'],
1973       
1974    ['CWNeutron', 'CWNeutron', 'Neutron CW Powder Data.htm',
1975       'CW Neutron Powder fit for Yttrium-Iron Garnet'],
1976    ['LabData', 'LabData', 'Laboratory X.htm',
1977       'Fitting laboratory X-ray powder data for fluoroapatite'],
1978    ['CWCombined', 'CWCombined', 'Combined refinement.htm',
1979       'Combined X-ray/CW-neutron refinement of PbSO4'],
1980    ['TOF-CW Joint Refinement', 'TOF-CW Joint Refinement', 'TOF combined XN Rietveld refinement in GSAS.htm',
1981       'Combined X-ray/TOF-neutron Rietveld refinement'],
1982    ['SeqRefine', 'SeqRefine', 'SequentialTutorial.htm',
1983       'Sequential refinement of multiple datasets'],
1984    ['SeqParametric', 'SeqParametric', 'ParametricFitting.htm',
1985       'Parametric Fitting and Pseudo Variables for Sequential Fits'],
1986       
1987    ['CFjadarite', 'CFjadarite', 'Charge Flipping in GSAS.htm',
1988       'Charge Flipping structure solution for jadarite'],
1989    ['CFsucrose', 'CFsucrose', 'Charge Flipping - sucrose.htm',
1990       'Charge Flipping structure solution for sucrose'],
1991    ['TOF Charge Flipping', 'TOF Charge Flipping', 'Charge Flipping with TOF single crystal data in GSASII.htm',
1992       'Charge flipping with neutron TOF single crystal data'],
1993    ['MCsimanneal', 'MCsimanneal', 'MCSA in GSAS.htm',
1994       'Monte-Carlo simulated annealing structure'],
1995
1996    ['2DCalibration', '2DCalibration', 'Calibration of an area detector in GSAS.htm',
1997       'Calibration of an area detector'],
1998    ['2DIntegration', '2DIntegration', 'Integration of area detector data in GSAS.htm',
1999       'Integration of area detector data'],
2000    ['TOF Calibration', 'TOF Calibration', 'Calibration of a TOF powder diffractometer.htm',
2001       'Calibration of a Neutron TOF diffractometer'],
2002       
2003    ['2DStrain', '2DStrain', 'Strain fitting of 2D data in GSAS-II.htm',
2004       'Strain fitting of 2D data'],
2005       
2006    ['SAimages', 'SAimages', 'Small Angle Image Processing.htm',
2007       'Image Processing of small angle x-ray data'],
2008    ['SAfit', 'SAfit', 'Fitting Small Angle Scattering Data.htm',
2009       'Fitting small angle x-ray data (alumina powder)'],
2010    ['SAsize', 'SAsize', 'Small Angle Size Distribution.htm',
2011       'Small angle x-ray data size distribution (alumina powder)'],
2012    ['SAseqref', 'SAseqref', 'Sequential Refinement of Small Angle Scattering Data.htm',
2013       'Sequential refinement with small angle scattering data'],
2014   
2015    #['TOF Sequential Single Peak Fit', 'TOF Sequential Single Peak Fit', '', ''],
2016    #['TOF Single Crystal Refinement', 'TOF Single Crystal Refinement', '', ''],
2017    )
2018if GSASIIpath.GetConfigValue('Tutorial_location'):
2019    tutorialPath = GSASIIpath.GetConfigValue('Tutorial_location')
2020else:
2021    tutorialPath = GSASIIpath.path2GSAS2
2022
2023class OpenTutorial(wx.Dialog):
2024    '''Open a tutorial, optionally copying it to the local disk. Always copy
2025    the data files locally.
2026
2027    For now tutorials will always be copied into the source code tree, but it
2028    might be better to have an option to copy them somewhere else, for people
2029    who don't have write access to the GSAS-II source code location.
2030    '''
2031    # TODO: set default input-file open location to the download location
2032    def __init__(self,parent=None):
2033        style=wx.DEFAULT_DIALOG_STYLE | wx.RESIZE_BORDER
2034        wx.Dialog.__init__(self, parent, wx.ID_ANY, 'Open Tutorial', style=style)
2035        self.frame = parent
2036        pnl = wx.Panel(self)
2037        sizer = wx.BoxSizer(wx.VERTICAL)
2038        label = wx.StaticText(
2039            pnl,  wx.ID_ANY,
2040            'Select the tutorial to be run and the mode of access'
2041            )
2042        sizer.Add(label, 0, wx.ALIGN_CENTRE|wx.ALL, 5)
2043        msg = '''To save download time for GSAS-II tutorials and their
2044        sample data files are being moved out of the standard
2045        distribution. This dialog allows users to load selected
2046        tutorials to their computer.
2047
2048        Tutorials can be viewed over the internet or downloaded
2049        to this computer. The sample data can be downloaded or not,
2050        (but it is not possible to run the tutorial without the
2051        data). If no web access is available, tutorials that were
2052        previously downloaded can be viewed.
2053
2054        By default, files are downloaded into the location used
2055        for the GSAS-II distribution, but this may not be possible
2056        if the software is installed by a administrator. The
2057        download location can be changed using the "Set data
2058        location" or the "Tutorial_location" configuration option
2059        (see config_example.py).
2060        '''
2061        hlp = HelpButton(pnl,msg)
2062        sizer.Add(hlp,0,wx.ALIGN_RIGHT|wx.ALL)
2063        #======================================================================
2064        # # This is needed only until we get all the tutorials items moved
2065        # btn = wx.Button(pnl, wx.ID_ANY, "Open older tutorials")
2066        # btn.Bind(wx.EVT_BUTTON, self.OpenOld)
2067        # sizer.Add(btn,0,wx.ALIGN_CENTRE|wx.ALL)
2068        #======================================================================
2069        self.BrowseMode = 1
2070        choices = [
2071            'make local copy of tutorial and data, then open',
2072            'run from web (copy data locally)',
2073            'browse on web (data not loaded)', 
2074            'open from local tutorial copy',
2075        ]
2076        self.mode = wx.RadioBox(pnl,wx.ID_ANY,'access mode:',
2077                                wx.DefaultPosition, wx.DefaultSize,
2078                                choices, 1, wx.RA_SPECIFY_COLS)
2079        self.mode.SetSelection(self.BrowseMode)
2080        self.mode.Bind(wx.EVT_RADIOBOX, self.OnModeSelect)
2081        sizer.Add(self.mode,0,WACV)
2082        sizer1 = wx.BoxSizer(wx.HORIZONTAL)
2083        btn = wx.Button(pnl, wx.ID_ANY, "Set download location")
2084        btn.Bind(wx.EVT_BUTTON, self.SelectDownloadLoc)
2085        sizer1.Add(btn,0,WACV)
2086        self.dataLoc = wx.StaticText(pnl, wx.ID_ANY,tutorialPath)
2087        sizer1.Add(self.dataLoc,0,WACV)
2088        sizer.Add(sizer1)
2089        self.listbox = wx.ListBox(pnl, wx.ID_ANY, size=(450, 100), style=wx.LB_SINGLE)
2090        self.listbox.Bind(wx.EVT_LISTBOX, self.OnTutorialSelected)
2091        self.OnModeSelect(None)
2092        #self.FillListBox()
2093        sizer.Add(self.listbox,1,WACV|wx.EXPAND|wx.ALL,1)
2094       
2095        btnsizer = wx.StdDialogButtonSizer()
2096        btn = wx.Button(pnl, wx.ID_CANCEL)
2097        btnsizer.AddButton(btn)
2098        btnsizer.Realize()
2099        sizer.Add(btnsizer, 0, wx.ALIGN_CENTER|wx.ALL, 5)
2100        pnl.SetSizer(sizer)
2101        sizer.Fit(self)
2102        self.topsizer=sizer
2103        self.CenterOnParent()
2104    # def OpenOld(self,event):
2105    #     '''Open old tutorials. This is needed only until we get all the tutorials items moved
2106    #     '''
2107    #     self.EndModal(wx.ID_OK)
2108    #     self.frame.Tutorials = True
2109    #     ShowHelp('Tutorials',self.frame)
2110    def OnModeSelect(self,event):
2111        '''Respond when the mode is changed
2112        '''
2113        self.BrowseMode = self.mode.GetSelection()
2114        if self.BrowseMode == 3:
2115            import glob
2116            filelist = glob.glob(os.path.join(tutorialPath,'help','*','*.htm'))
2117            taillist = [os.path.split(f)[1] for f in filelist]
2118            itemlist = [tut[-1] for tut in tutorialCatalog if tut[2] in taillist]
2119        else:
2120            itemlist = [tut[-1] for tut in tutorialCatalog if tut[-1]]
2121        self.listbox.Clear()
2122        self.listbox.AppendItems(itemlist)
2123    def OnTutorialSelected(self,event):
2124        '''Respond when a tutorial is selected. Load tutorials and data locally,
2125        as needed and then display the page
2126        '''
2127        for tutdir,exedir,htmlname,title in tutorialCatalog:
2128            if title == event.GetString(): break
2129        else:
2130            raise Exception("Match to file not found")
2131        if self.BrowseMode == 0 or self.BrowseMode == 1:
2132            try: 
2133                self.ValidateTutorialDir(tutorialPath,G2BaseURL)
2134            except:
2135                G2MessageBox(self.frame,
2136            '''The selected directory is not valid.
2137           
2138            You must use a directory that you have write access
2139            to. You can reuse a directory previously used for
2140            downloads, but the help and Tutorials subdirectories
2141             must be created by this routine.
2142            ''')
2143                return
2144        self.dataLoc.SetLabel(tutorialPath)
2145        self.EndModal(wx.ID_OK)
2146        wx.BeginBusyCursor()
2147        if self.BrowseMode == 0:
2148            # xfer data & web page locally, then open web page
2149            self.LoadTutorial(tutdir,tutorialPath,G2BaseURL)
2150            self.LoadExercise(exedir,tutorialPath,G2BaseURL)
2151            URL = os.path.join(tutorialPath,'help',tutdir,htmlname)
2152            ShowWebPage(URL,self.frame)
2153        elif self.BrowseMode == 1:
2154            # xfer data locally, open web page remotely
2155            self.LoadExercise(exedir,tutorialPath,G2BaseURL)
2156            URL = os.path.join(G2BaseURL,'Tutorials',tutdir,htmlname)
2157            ShowWebPage(URL,self.frame)
2158        elif self.BrowseMode == 2:
2159            # open web page remotely, don't worry about data
2160            URL = os.path.join(G2BaseURL,'Tutorials',tutdir,htmlname)
2161            ShowWebPage(URL,self.frame)
2162        elif self.BrowseMode == 3:
2163            # open web page that has already been transferred
2164            URL = os.path.join(tutorialPath,'help',tutdir,htmlname)
2165            ShowWebPage(URL,self.frame)
2166        else:
2167            wx.EndBusyCursor()
2168            raise Exception("How did this happen!")
2169        wx.EndBusyCursor()
2170    def ValidateTutorialDir(self,fullpath=tutorialPath,baseURL=G2BaseURL):
2171        '''Load help to new directory or make sure existing directory looks correctly set up
2172        throws an exception if there is a problem.
2173        '''
2174        if os.path.exists(fullpath):
2175            if os.path.exists(os.path.join(fullpath,"help")):
2176                if not GSASIIpath.svnGetRev(os.path.join(fullpath,"help")):
2177                    print("Problem with "+fullpath+" dir help exists but is not in SVN")
2178                    raise Exception
2179            if os.path.exists(os.path.join(fullpath,"Exercises")):
2180                if not GSASIIpath.svnGetRev(os.path.join(fullpath,"Exercises")):
2181                    print("Problem with "+fullpath+" dir Exercises exists but is not in SVN")
2182                    raise Exception
2183            if (os.path.exists(os.path.join(fullpath,"help")) and
2184                    os.path.exists(os.path.join(fullpath,"Exercises"))):
2185                return True # both good
2186            elif (os.path.exists(os.path.join(fullpath,"help")) or
2187                    os.path.exists(os.path.join(fullpath,"Exercises"))):
2188                print("Problem: dir "+fullpath+" exists has either help or Exercises, not both")
2189                raise Exception
2190        wx.BeginBusyCursor()
2191        if not GSASIIpath.svnInstallDir(baseURL+"/MT",fullpath):
2192            wx.EndBusyCursor()
2193            print("Problem transferring empty directory from web")
2194            raise Exception
2195        wx.EndBusyCursor()
2196        return True
2197
2198    def LoadTutorial(self,tutorialname,fullpath=tutorialPath,baseURL=G2BaseURL):
2199        'Load a Tutorial to the selected location'
2200        if GSASIIpath.svnSwitchDir("help",tutorialname,baseURL+"/Tutorials",fullpath):
2201            return True
2202        print("Problem transferring Tutorial from web")
2203        raise Exception
2204       
2205    def LoadExercise(self,tutorialname,fullpath=tutorialPath,baseURL=G2BaseURL):
2206        'Load Exercise file(s) for a Tutorial to the selected location'
2207        if GSASIIpath.svnSwitchDir("Exercises",tutorialname,baseURL+"/Exercises",fullpath):
2208            return True
2209        print ("Problem transferring Exercise from web")
2210        raise Exception
2211       
2212    def SelectDownloadLoc(self,event):
2213        '''Select a download location,
2214        Cancel resets to the default
2215        '''
2216        global tutorialPath
2217        localpath = os.path.abspath(os.path.expanduser('~/G2tutorials'))
2218        dlg = wx.DirDialog(self, "Choose a directory for downloads:",
2219                           defaultPath=localpath)#,style=wx.DD_DEFAULT_STYLE)
2220                           #)
2221        if dlg.ShowModal() == wx.ID_OK:
2222            pth = dlg.GetPath()
2223        else:
2224            if GSASIIpath.GetConfigValue('Tutorial_location'):
2225                pth = GSASIIpath.GetConfigValue('Tutorial_location')
2226            else:
2227                pth = GSASIIpath.path2GSAS2
2228        if not os.path.exists(pth):
2229            try:
2230                os.makedirs(pth)
2231            except OSError:
2232                msg = 'The selected directory is not valid.\n\t'
2233                msg += pth
2234                msg += '\n\nAn attempt to create the directory failed'
2235                G2MessageBox(self.frame,msg)
2236                return
2237        self.ValidateTutorialDir(pth,G2BaseURL)
2238        try: 
2239            self.ValidateTutorialDir(pth,G2BaseURL)
2240            tutorialPath = pth
2241        except:
2242            G2MessageBox(self.frame,
2243            '''The selected directory is not valid.
2244           
2245            You must use a directory that you have write access
2246            to. You can reuse a directory previously used for
2247            downloads, but the help and Tutorials subdirectories
2248             must be created by this routine.
2249            ''')
2250        self.dataLoc.SetLabel(tutorialPath)
2251   
2252if __name__ == '__main__':
2253    app = wx.PySimpleApp()
2254    GSASIIpath.InvokeDebugOpts()
2255    frm = wx.Frame(None) # create a frame
2256    frm.Show(True)
2257    dlg = OpenTutorial(frm)
2258    if dlg.ShowModal() == wx.ID_OK:
2259        print "OK"
2260    else:
2261        print "Cancel"
2262    dlg.Destroy()
2263    import sys
2264    sys.exit()
2265    #======================================================================
2266    # test ScrolledMultiEditor
2267    #======================================================================
2268    # Data1 = {
2269    #      'Order':1,
2270    #      'omega':'string',
2271    #      'chi':2.0,
2272    #      'phi':'',
2273    #      }
2274    # elemlst = sorted(Data1.keys())
2275    # prelbl = sorted(Data1.keys())
2276    # dictlst = len(elemlst)*[Data1,]
2277    #Data2 = [True,False,False,True]
2278    #Checkdictlst = len(Data2)*[Data2,]
2279    #Checkelemlst = range(len(Checkdictlst))
2280    # print 'before',Data1,'\n',Data2
2281    # dlg = ScrolledMultiEditor(
2282    #     frm,dictlst,elemlst,prelbl,
2283    #     checkdictlst=Checkdictlst,checkelemlst=Checkelemlst,
2284    #     checklabel="Refine?",
2285    #     header="test")
2286    # if dlg.ShowModal() == wx.ID_OK:
2287    #     print "OK"
2288    # else:
2289    #     print "Cancel"
2290    # print 'after',Data1,'\n',Data2
2291    # dlg.Destroy()
2292    Data3 = {
2293         'Order':1.0,
2294         'omega':1.1,
2295         'chi':2.0,
2296         'phi':2.3,
2297         'Order1':1.0,
2298         'omega1':1.1,
2299         'chi1':2.0,
2300         'phi1':2.3,
2301         'Order2':1.0,
2302         'omega2':1.1,
2303         'chi2':2.0,
2304         'phi2':2.3,
2305         }
2306    elemlst = sorted(Data3.keys())
2307    dictlst = len(elemlst)*[Data3,]
2308    prelbl = elemlst[:]
2309    prelbl[0]="this is a much longer label to stretch things out"
2310    Data2 = len(elemlst)*[False,]
2311    Data2[1] = Data2[3] = True
2312    Checkdictlst = len(elemlst)*[Data2,]
2313    Checkelemlst = range(len(Checkdictlst))
2314    #print 'before',Data3,'\n',Data2
2315    #print dictlst,"\n",elemlst
2316    #print Checkdictlst,"\n",Checkelemlst
2317    dlg = ScrolledMultiEditor(
2318        frm,dictlst,elemlst,prelbl,
2319        checkdictlst=Checkdictlst,checkelemlst=Checkelemlst,
2320        checklabel="Refine?",
2321        header="test",CopyButton=True)
2322    if dlg.ShowModal() == wx.ID_OK:
2323        print "OK"
2324    else:
2325        print "Cancel"
2326    #print 'after',Data3,'\n',Data2
2327
2328    # Data2 = list(range(100))
2329    # elemlst += range(2,6)
2330    # postlbl += range(2,6)
2331    # dictlst += len(range(2,6))*[Data2,]
2332
2333    # prelbl = range(len(elemlst))
2334    # postlbl[1] = "a very long label for the 2nd item to force a horiz. scrollbar"
2335    # header="""This is a longer\nmultiline and perhaps silly header"""
2336    # dlg = ScrolledMultiEditor(frm,dictlst,elemlst,prelbl,postlbl,
2337    #                           header=header,CopyButton=True)
2338    # print Data1
2339    # if dlg.ShowModal() == wx.ID_OK:
2340    #     for d,k in zip(dictlst,elemlst):
2341    #         print k,d[k]
2342    # dlg.Destroy()
2343    # if CallScrolledMultiEditor(frm,dictlst,elemlst,prelbl,postlbl,
2344    #                            header=header):
2345    #     for d,k in zip(dictlst,elemlst):
2346    #         print k,d[k]
2347
2348    #======================================================================
2349    # test G2MultiChoiceDialog
2350    #======================================================================
2351    # choices = []
2352    # for i in range(21):
2353    #     choices.append("option_"+str(i))
2354    # dlg = G2MultiChoiceDialog(frm, 'Sequential refinement',
2355    #                           'Select dataset to include',
2356    #                           choices)
2357    # sel = range(2,11,2)
2358    # dlg.SetSelections(sel)
2359    # dlg.SetSelections((1,5))
2360    # if dlg.ShowModal() == wx.ID_OK:
2361    #     for sel in dlg.GetSelections():
2362    #         print sel,choices[sel]
2363   
2364    #======================================================================
2365    # test wx.MultiChoiceDialog
2366    #======================================================================
2367    # dlg = wx.MultiChoiceDialog(frm, 'Sequential refinement',
2368    #                           'Select dataset to include',
2369    #                           choices)
2370    # sel = range(2,11,2)
2371    # dlg.SetSelections(sel)
2372    # dlg.SetSelections((1,5))
2373    # if dlg.ShowModal() == wx.ID_OK:
2374    #     for sel in dlg.GetSelections():
2375    #         print sel,choices[sel]
2376
2377    pnl = wx.Panel(frm)
2378    siz = wx.BoxSizer(wx.VERTICAL)
2379
2380    td = {'Goni':200.,'a':1.,'calc':1./3.,'string':'s'}
2381    for key in sorted(td):
2382        txt = ValidatedTxtCtrl(pnl,td,key)
2383        siz.Add(txt)
2384    pnl.SetSizer(siz)
2385    siz.Fit(frm)
2386    app.MainLoop()
2387    print td
Note: See TracBrowser for help on using the repository browser.