December 2006 - cctbxbb - phenix-online.org

Re: [cctbxbb] Error in fractional coordinates returned by cctbx
by Ralf W. Grosse-Kunstleve 29 Dec '06

29 Dec '06

> We could add .mod_positive() and .mod_short() methods to flex.xray_scatterer, and > then the corresponding two-liners .sites_mod_positive() and .sites_mod_short() to > xray.structure. I'll put it on my to-do list. Done: http://cci.lbl.gov/cctbx_build/all.html Build 2006_12_28_2147 or later includes the new methods. E.g.: p1_structure = structure.expand_to_p1().sites_mod_positive() HTH, Ralf __________________________________________________ Do You Yahoo!? Tired of spam? Yahoo! Mail has the best spam protection around http://mail.yahoo.com

2 1

Re: [cctbxbb] Error in fractional coordinates returned by cctbx
by Ralf W. Grosse-Kunstleve 29 Dec '06

29 Dec '06

> flex.fmod_positive( coordinates, 1 ) > > on the fractional coordinates on your sites. > > Ralf, is there a better way? No, Peter's Python loop over the scatterers is currently the best solution. We could add .mod_positive() and .mod_short() methods to flex.xray_scatterer, and then the corresponding two-liners .sites_mod_positive() and .sites_mod_short() to xray.structure. I'll put it on my to-do list. Cheers, Ralf __________________________________________________ Do You Yahoo!? Tired of spam? Yahoo! Mail has the best spam protection around http://mail.yahoo.com

1 0

Error in fractional coordinates returned by cctbx
by David A Carr 28 Dec '06

28 Dec '06

Hello, I have encountered the following inconsistency when working with cctbx. The compound I am working with is as follows. #Silicon Dioxide Quartz low. #Si O2 #ICSD Coll Number 62410 label="Si", site=(0.4643,0.0,0.6667) label="O", site=(0.411,0.2773,0.7783) unit_cell="4.8430, 4.8430, 5.3480, 90.0, 90.0, 120.0", space_group_symbol="P 32 2 1" The error is can be seen in the below. In the second and third Si lines the z value is not a fraction of the unit. Similarly two of the oxygens are placed outside the unit cell. Why does cctbx place these outside of the unit cell? Number of scatterers: 9 At special positions: 0 Unit cell: (4.843, 4.843, 5.348, 90, 90, 120) Space group: P 1 (No. 1) Label, Scattering, Multiplicity, Coordinates, Occupancy, Uiso Si1 Si 1 ( 0.4643 0.0000 0.6667) 1.00 0.0000 Si1 Si 1 ( 0.0000 0.4643 1.3333) 1.00 0.0000 Si1 Si 1 (-0.4643 -0.4643 1.0000) 1.00 0.0000 O1 O 1 ( 0.4110 0.2773 0.7783) 1.00 0.0000 O1 O 1 (-0.2773 0.1337 1.4450) 1.00 0.0000 O1 O 1 (-0.1337 -0.4110 1.1116) 1.00 0.0000 O1 O 1 ( 0.1337 -0.2773 -0.4450) 1.00 0.0000 O1 O 1 (-0.4110 -0.1337 -0.1116) 1.00 0.0000 O1 O 1 ( 0.2773 0.4110 -0.7783) 1.00 0.0000 Below shows the expected fractional coordinates as expected. Based on the space group P 32 2 1. 0.4643 0.0000 0.6667 0.0000 0.4643 0.3333 -0.4643 -0.4643 0.0000 0.4110 0.2773 0.7783 -0.2773 0.1337 0.4450 -0.1337 -0.4110 0.1116 0.1337 -0.2773 -0.4450 -0.4110 -0.1337 -0.1116 0.2773 0.4110 -0.7783 Any insight into this would be of help. I am hoping to use cctbx as a part of our current software development project. Thanks, D.Andrew Carr dcarr2(a)gmu.edu # Below is the code that generates the error # posted above. #--------------------------------------------------- from cctbx import xray from cctbx import crystal from cctbx.array_family import flex def demo(): crystal_symmetry = crystal.symmetry( unit_cell="4.8430, 4.8430, 5.3480, 90.0, 90.0, 120.0", space_group_symbol="P 32 2 1") scatterers = flex.xray_scatterer() scatterers.append(xray.scatterer( label="Si", site=(0.4643,0.0,0.6667))) scatterers.append(xray.scatterer( label="O", site=(0.411,0.2773,0.7783))) icsd_structure = xray.structure( crystal_symmetry=crystal_symmetry, scatterers=scatterers) print "ICSD Structure" icsd_structure.show_summary().show_scatterers() print icsd_structure.show_distances(distance_cutoff=2.5) print "Primitive" primitive_structure = icsd_structure.primitive_setting() primitive_structure.show_summary().show_scatterers() print p1_structure = primitive_structure.expand_to_p1() p1_structure.show_summary().show_scatterers() print print "Expanded to P1" icsd_structure.expand_to_p1().show_summary().show_scatterers() print "OK" if (__name__ == "__main__"): demo()

3 8

Re: [cctbxbb] Possible contributions to the cctbx
by Luc Bourhis 16 Dec '06

16 Dec '06

On 16 Dec 2006, at 06:53, Ralf W. Grosse-Kunstleve wrote: >> We have not developed those two features yet. Fair enough about the >> smtbx… We can easily mimic the mmtbx, > > I just wanted to say that you are most welcome to start the smtbx > tree under the cctbx SF probject. This is just an offer, I'd be > just as happy if you decide to start the tree somewhere else. Oh, I see! Sorry, I misunderstood you then. Thanks for the offer. It would make sense indeed. Of course, our ultimate goal is to develop the equivalent of Phenix for small molecules, and that would not live on sourceforge.net/projects/cctbx either. > It is technically very easy to leverage the cctbx build system for > other modules (I have at least 20 other modules floating around), > i.e. so that you can say libtbx/configure.py smtbx and you'll have > everything set up (PYTHONPATH, PATH, smtbx.python, etc.). The > problem is it is not documented enough (just Michael > Hohn's notes at http://cci.lbl.gov/~hohn/scitbx-tour.html). I hope > to find time to write more detailed web pages over the holiday break. I would highly appreciate that. By easy you probably mean it boils down to add a few instructions in a config file but my experience is that finding out those in the first place is not easy! Anyway, I am afraid I will come back to you with countless questions when I will start to develop with the cctbx. Thanks again, Luc

1 0

Re: [cctbxbb] Possible contributions to the cctbx
by Ralf W. Grosse-Kunstleve 15 Dec '06

15 Dec '06

Hi Luc, > This is a spin-off from the thread about constrained hydrogen > refinement. On the todo list of our EPSRC project, we have a few more > items which I think would fit well in the cctbx. > > 1) anharmonic thermal displacements. Not only the Gram-Charlier ones > but also about the modelling of atoms disordered over a circle or a > line (as done in Crystals [1]). > > 2) multipolar scattering factors, for charge density studies. These suggestions look quite specific to small molecule crystallography. They make me think it would be best to have a "smtbx" (small molecule toolbox) module (inspired by David's message). Do you have a CVS or SVN repository already? Is it publicly accessible (read only)? Cheers, Ralf __________________________________________________ Do You Yahoo!? Tired of spam? Yahoo! Mail has the best spam protection around http://mail.yahoo.com

2 1

Re: [cctbxbb] constrained hydrogen geometry
by Ralf W. Grosse-Kunstleve 15 Dec '06

15 Dec '06

Hi Luc, > I was trying to figure out whether this interface would be sufficient > and/or necessary for the Hydrogen geometry constraints. I am not > quite sure I understand what is gradient_sum_matrix exactly in fact. gradient_sum_matrix is not directly relevant to the hydrogen problem. The only commonality is the chain rule. Roughly, if you have to variables x, y which are "normally" independent and have gradients df/dx and df/dy, and if under "special circumstances" x becomes a function of y (or vice versa), you have to add up the gradients according to the chain rule. If you work this out for the linear relations given by the symmetry operations, you can cast the result in the form of the "gradient sum matrices". Below is a simple example, by Peter Zwart, constraining the sum of occupancies to one. In the hydrogen case, I'd think you just write down the equations constraining the coordinates to each other. Then study them to apply the chain rule. Done! :) Regarding the interfaces: I usually think about interfaces after I've worked out the math and/or algorithms. It is good to make interfaces as similar as possible, but ultimately "form follows function", as a famous architect taught us. Most importantly, find class, function and variable names that convey meaning even to the "reader" no immersed in the problem. That's more than half the battle. > It is the philosophy of the cctbx, isn't it? You have constructed > the cctbx so as to use it as Python library, relegating C++ to some > sort of assembly language for efficiency. Yes, that's a good viewpoint. > The lack of abstraction in the C++ code of the cctbx I don't know what you mean. :) > (hardly any inheritance, Because it has a large potential for obfuscating what's going on. Inheritance is like salt in the soup. > no advanced genericity) You must have overlooked Boost.Python. :) If that doesn't change your mind, look closer at the implementation of the array algebra header files in scitbx/array_family, including the auto-generated header files in cctbx_build/include. > would require wrapping a lot of the cctbx classes behind > proxies inheriting from abstract types. I find this approach cumbersome and fruitless. I am a big believer in form follows function. Function follows form (design interfaces first) doesn't work for me. I always try to achieve first what I actually want to do, then find a good form for it. > A typical example for me are those classes dealing > with position constraints and ADP constraints. They > are unrelated in C++, cctbx::sgtbx::site_constraints and > cctbx::sgtbx::tensor_rank_2::constraints, although they have both have > the same member functions listed above. Functionally the member functions are unrelated, unless you can come up with a general engine that applies the chain rule automatically to a given function. (Such tools exist, e.g. adolc, but are heavy-duty.) I think it would be counter-productive to tie adp/site constraints code together just because the names of the methods are similar. I consider modularity a more important value. > Of course, from Python, it does not matter, thanks to duck typing: > if two objects answer the same method calls, then they are by all > practical means of the same type. The adp/site constraints are not a good example. We don't want to use them interchangeably. I've tried to use the "functor" idea (unifies interfaces without inheritance) in some places, but even that often turns out to be a struggle. This is especially the case when another person adds on (e.g. cctbx.xray.target_functors). What counts the most in my opinion is to avoid redundancy. That's my most important goal when writing source code, because redundancy hampers progress and multiplies bugs, among other bad things. I'm trying to use all tools available to cut back redundancy. I find both templates and inheritance invaluable and use them where they help reducing redundancy, but I do not see "use templates" or "use inheritance" as goals in their own right. > Our group would be more than happy to contribute them to the cctbx > since we absolutely need them for our project. That's great! I think you can achieve a lot quickly if you limit yourself initially to Python. If you then check in what you have, I'd be happy to walk you through the first few times moving time-critical functionality to C++. Cheers, Ralf By Peter Zwart: Some ideas on how to restrain sums of variables to unity. say we have f(a,b,c) with a(x1) = x1 b(x2) = x2 c(x1,x2) = 1 - x1 - x2 Say we have from the refinement engine the following numerical values (right hand side) for our partial derivatives: df/da = Ga df/db = Gb df/dc = Gc The chain rule says: dq/dx = (dq/du)(du/dx) + (dq/dv)(dv/dx) Thus df/dx1 = (df/da)(da/dx1) + (df/dc)(dc/dx1) = Ga - Gc df/dx2 = (df/db)(db/dx2) + (df/dc)(dc/dx2) = Gb - Gc This gives you the rule to go from the full set of derivatives to the reduced set of derivatives (for the general case): #-------------------------------------------------- def pack_derivatives( g_array ): result = g_array[0:g_array.size()-1 ] result = result - g_array[ g_array.size()-1 ] return result #-------------------------------------------------- You also need to go from a reduced set of parameters to the full set of parameters (for the general case): #-------------------------------------------------- def expand_parameters( x ): result = x.deep_copy() result = result.append( 1 - flex.sum(x) ) return result #-------------------------------------------------- This of course assumes that the 'last' variable is the non unique none during refinement. ____________________________________________________________________________________ Any questions? Get answers on any topic at www.Answers.yahoo.com. Try it now.

1 0

Possible contributions to the cctbx
by Luc Bourhis 14 Dec '06

14 Dec '06

This is a spin-off from the thread about constrained hydrogen refinement. On the todo list of our EPSRC project, we have a few more items which I think would fit well in the cctbx. 1) anharmonic thermal displacements. Not only the Gram-Charlier ones but also about the modelling of atoms disordered over a circle or a line (as done in Crystals [1]). 2) multipolar scattering factors, for charge density studies. [1] L. Schröder, D.J. Watkin, A. Cousson, R.I. Cooper, and W. Paulus. Crystals enhancements: refinement of atoms continuously disordered along a line, on a ring or on the surface of a sphere. J. Appl. Cryst., 37:545–550, 2004. Best wishes, Luc

1 0

Re: [cctbxbb] constrained hydrogen geometry
by Ralf W. Grosse-Kunstleve 14 Dec '06

14 Dec '06

Hi Luc, > I have not been able to find any facility to constraint hydrogen > geometry, in the manner of the AFIX in ShelXL I mean. Have I missed > them or would it need to be implemented? They need to be implemented. > In the latter case, I have tried to figure out how this could be > done. I manage to find how position and ADP constraints are handled > by constraint objects featuring methods to return the independent > variables and the gradient with respect to them. Then cctbx/cctbx/ > examples/structure_factor_derivatives_4.py shows how those features > can be used. Would Hydrogen geometry constraint be best handled by > mimicking those special positions constraint? I am not sure. The handling of hydrogens seems more complicated than dealing with the constraints due to symmetry. I just had a quick look at the SHELX manual. I see many special cases. If I had a chance to work on this, I'd start with a Python script emulating some of the cases handled by SHELX, refining a few small structures. After getting a few concrete examples to work, I'd try to generalize the procedures for handling the special cases. I'd switch to C++ only after having fully conquered the math and the bookkeeping in Python, and being sure about the final interfaces. To implement the core refinement, I'd copy and modify cctbx/cctbx/xray/minimization.py. See also phenix/phenix/substructure/hyss/minimization.py, which you can find in the CCI Apps bundle (http://phenix-online.org/download/cci_apps/). Hope this helps. As you can tell, I am not an expert in constrained hydrogen refinement, but I'm very interested in seeing such algorithms in the cctbx (we'd probably want to use them in phenix.refine). Let me know if you feel I can do something to help out. Cheers, Ralf ____________________________________________________________________________________ Cheap talk? Check out Yahoo! Messenger's low PC-to-Phone call rates. http://voice.yahoo.com

2 1

constrained hydrogen geometry
by Luc Bourhis 14 Dec '06

14 Dec '06

I have not been able to find any facility to constraint hydrogen geometry, in the manner of the AFIX in ShelXL I mean. Have I missed them or would it need to be implemented? In the latter case, I have tried to figure out how this could be done. I manage to find how position and ADP constraints are handled by constraint objects featuring methods to return the independent variables and the gradient with respect to them. Then cctbx/cctbx/ examples/structure_factor_derivatives_4.py shows how those features can be used. Would Hydrogen geometry constraint be best handled by mimicking those special positions constraint? Cheers, luc

1 0

Re: [cctbxbb] Fail to extend space-group with centring translations
by Ralf W. Grosse-Kunstleve 11 Dec '06

11 Dec '06

> I believe Ralph can handle C-1 Yes, most definitely. There are no rational rotation matrix elements => no problem. > In each pair of tables 4 & 5 and 6 & 7 atomic parameters can be > compared directly. If the P to C transformation is made, all four > tables can be compared by inspection. I believe you can always achieve this even with the cctbx as is. You just may have to transform both structures to some unusual setting. Consider that matrices with rational rotation parts elements are not only relatively expensive to handle, but the corresponding geometry is also highly non-intuitive. I.e. if you transform both structures to avoid the rational rotation parts I bet the comparison is easier to explain and understand. The usual trick is to use space_group_type to go to reference settings, then .niggli_cell() to go to primitive settings, then deal with the extra translations in the primitive settings. Technically it comes down to combining the change-of-basis matrices in the right way, which is easy. > In this case, the referees and editors refused to accept a non standard > SG, so the text of the paper becomes laborious, explaining what would > otherwise have been obvious. If you give change-of-basis matrices from the reference setting (using space_group_type) I think it should be easy to argue the case for presenting the comparison using a convenient frame of reference. Note that the space_group_type has a ".universal_hermann_mauguin_symbol()" method to produce "nice" general space group symbols for any setting that can be handled by the space_group class. We use this in the automatic generation of subgroup graphs. E.g. try this: iotbx.explore_metric_symmetry --unit-cell "68.4 68.4 68.3 109.5 109.4 109.5" --space-group=p1 --graph graph.png For this to work you need graphviz (open source). If you don't have it, here is the resulting png file: http://cci.lbl.gov/~rwgk/tmp/explore_metric_symmetry_graph.png > In higer symmetry SGs it may be easier to compare structures if even more > bizzare SG are invented, or if non-standard origins are used. I don't think it is a problem if you use the right existing tools. :) > Im sure this will be true, and that someone will provide the > user-interface for generating the basis vectors form the new (probably > enlarged) cell and new atomic parameters after the expansion. I'd be happy to help integrate the required additions. > Im sure the SM-tbx folk have more pressing problems to deal with than > worrying about this minority application The core "cctbx" (the module, not the project, see Comp. Comm. Newsletter No. 1) is meant to be a small-molecule toolbox. Please don't view it as "read only", unless you don't want to release your additions as open source. (?) Cheers, Ralf ____________________________________________________________________________________ Do you Yahoo!? Everyone is raving about the all-new Yahoo! Mail beta. http://new.mail.yahoo.com

1 0