<html><head></head><body style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space; ">Hi everyone,<div><div><font class="Apple-style-span" color="#0057ce"><br></font></div><div>I have a couple of comments related to the negative comment on the yt survey. In particular, there is one part I agree with and one I do not:<br><font class="Apple-style-span" color="#0057ce"><br></font>The comment about yt being heavily cosmology based I do not agree with. As a non-cosmo simulator --one who still intends to torch a fellow developer's house for declaring all my research 'test problems' at a user meeting-- I use yt for all my simulation analysis and use a wide range of its capabilities. In fact, the only part I can think that I do not use is the halo finder, but I do use connected sets which is a similar idea for gas. <br><font class="Apple-style-span" color="#0057ce"><br></font>I therefore feel this comment is not part of the general consensus and can be ignored. <br><font class="Apple-style-span" color="#0057ce"><br></font>However, the comment about the documentation being from the user's rather than the programmer's, point of view is interesting and think worth some thought. For a while, I skirted around yt, aware that it was powerful but baulking at the effort needed to use it comfortably. Last summer, I had to write an entirely new analysis program for my simulations and I bit the bullet and starting working extensively with yt and python. I've never picked up an IDL script since, but there was definitely an energy bump. I also think that I do find the documentation **significantly** clearer now I approach it from a programmer's perspective. <br><font class="Apple-style-span" color="#0057ce"><br></font>I have a couple of suggestions of what I think might help with this:<br><font class="Apple-style-span" color="#0057ce"><br></font>(1) The quickest option is to keep everything the same but add more actual examples. For instance, the routine call, e.g.<br><font class="Apple-style-span" color="#0057ce"><br></font><span class="Apple-style-span" style="font-family: monospace; ">contour(self, field, ncont=5, factor=4, take_log=False, clim=None, plot_args=None):</span><br><font class="Apple-style-span" color="#0057ce" face="monospace"><br></font>is confusion for a non-programmer. When I first came to yt, I spent a while with thoughts like:<br><font class="Apple-style-span" color="#0057ce"><br></font>What is 'self'? Do I need to pass it like in C++ with Grid-> ? <br><font class="Apple-style-span" color="#0057ce"><br></font>Although it's slightly painful, I think it would be much improved if there was an actual call example for each one of the callbacks and other tools. So we'd have:<br><font class="Apple-style-span" color="#0057ce"><br></font><span class="Apple-style-span" style="font-family: monospace; ">contour(self, field, ncont=5, factor=4, take_log=False, clim=None, plot_args=None):</span><br>(This is a proxy for <a class="reference internal" href="http://yt-project.org/doc/reference/api/generated/yt.visualization.plot_modifications.ContourCallback.html#yt.visualization.plot_modifications.ContourCallback" title="yt.visualization.plot_modifications.ContourCallback"><tt class="xref py py-class docutils literal"><span class="pre">ContourCallback</span></tt></a>.)<br>pc.modify["contours"]("Density", ncont=1, take_log=False)<br>Add contours in <em>field</em> to the plot.  <em>ncont</em> governs the
number of contours generated, <em>factor</em> governs the number
of points used in the interpolation, <em>take_log</em> governs
how it is contoured and <em>clim</em> gives the (upper, lower)
limits for contouring.<br><font class="Apple-style-span" color="#0057ce"><br><br></font>(2) My second suggestion involves the gui and concerns the way yt is presented. Currently, we talk about scripts and then mention there is a gui. How about we do it the other way around? So a new user's first port of call should be the gui. Then, we get to the section "beyond the gui" and talk about scripting and cookbook-ing and then finally onto full simulation analysis, i.e. writing whatever analysis package you like in python, but making use of the routines yt has.<br><font class="Apple-style-span" color="#0057ce"><br></font>For instance, in the workshop we just had at Hokudai, we could have stood up and brought up the yt gui before anything else. *Then* gone onto scripts.<br><font class="Apple-style-span" color="#0057ce"><br></font>The docs could be rearranged in a similar fashion.<br><font class="Apple-style-span" color="#0057ce"><br></font>I think this might provide a much faster way for new users to start getting into yt and make the gui of much more interest. Currently, people come to it after they learn to script at which point, its value is much less because it's inevitably more limited. <br><font class="Apple-style-span" color="#0057ce"><br><br></font>Elizabeth<br><font class="Apple-style-span" color="#0057ce"><br></font>PS today's google-doodle (or possible tomorrow's for the USA) is awesome.<br><font class="Apple-style-span" color="#0057ce"><br><br></font><div style="word-wrap: break-word; -webkit-nbsp-mode: space; -webkit-line-break: after-white-space; "><div><br></div></div></div><br></div></body></html>