<div dir="ltr">That said, notebooks do really help combining code and narrative discussion, and I don't think we should completely abandon notebooks in our documentation. Instead we should clarify in the quickstart at least that the notebooks are not necessary to work with yt, and are only used because they are a convenient vehicle for conveying the presented information.</div><div class="gmail_extra"><br><div class="gmail_quote">On Thu, Mar 17, 2016 at 10:23 PM, Nathan Goldbaum <span dir="ltr"><<a href="mailto:nathan12343@gmail.com" target="_blank">nathan12343@gmail.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr"><br><div class="gmail_extra"><br><div class="gmail_quote"><span class="">On Thu, Mar 17, 2016 at 8:19 PM, Joseph Smidt <span dir="ltr"><<a href="mailto:josephsmidt@gmail.com" target="_blank">josephsmidt@gmail.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex">For what it's worth, last year I had summer students who simulated<br>
large datasets (Enzo) that had to stay on the LANL machine they were<br>
simulated on and ipython notebooks were not available as LANL<br>
restricts web-browsers on their production machines.<br>
<br>
Long story short, all documentation that required a notebook to run<br>
were inaccessible to these students.  If the intro documentation could<br>
be rewritten so that it can also run in a terminal without a notebook<br>
that would be nice.<br></blockquote><div><br></div></span><div>So this exists, but we just don't make a huge deal about it. In fact all of the notebooks in the documentation have a "download as python script" option.</div><div><br></div><div>Here is a link to notebook 2 in the quickstart, in python script form:</div><div><br></div><div><a href="http://yt-project.org/docs/dev/quickstart/2)_Data_Inspection.py" target="_blank">http://yt-project.org/docs/dev/quickstart/2)_Data_Inspection.py</a><br></div><div><br></div><div>I think it would be possible to clean these up a bit and display them more prominently, or even provide alternate versions that are explicitly set up to be run as scripts.</div><div><br></div><div>We should also probably make a bigger deal on the quickstart page that all of the code in the notebooks themselves (with the exception of the show() methods of yt plot objects, which I'd really like to not only work in the notebook but alas that's the status quo) do not require notebooks, and is runnable in a normal python or terminal IPython session.</div><div><div class="h5"><div><br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex"><div><div>
<br>
<br>
On Thu, Mar 17, 2016 at 6:16 PM, Matthew Turk <<a href="mailto:matthewturk@gmail.com" target="_blank">matthewturk@gmail.com</a>> wrote:<br>
> There's a lot of information in this ticket, and I wanted to highlight<br>
> it for folks on the dev list that might otherwise filter these out.<br>
> Sadly, the person who left it hasn't left any contact info.  But, that<br>
> doesn't mean that it can't be synthesized into a plan of action,<br>
> particularly for improving documentation, 2D data, and so on.  One<br>
> important thing, which I personally hadn't realized is a problem, is<br>
> the repeated mentions that non-notebook access should be emphasized.<br>
><br>
> On Thu, Mar 17, 2016 at 6:45 PM, Anonymous <<a href="mailto:issues-reply@bitbucket.org" target="_blank">issues-reply@bitbucket.org</a>> wrote:<br>
>> New issue 1188: Trouble Getting Started with yt<br>
>> <a href="https://bitbucket.org/yt_analysis/yt/issues/1188/trouble-getting-started-with-yt" rel="noreferrer" target="_blank">https://bitbucket.org/yt_analysis/yt/issues/1188/trouble-getting-started-with-yt</a><br>
>><br>
>> Anonymous:<br>
>><br>
>> I'm a new user to yt and I've been having a really frustrating time getting started. I work with large simulations and have been using VisIt for 2D data. I want to switch to yt but the frustration of just trying to get it to run almost made me quit and go back to VisIt.<br>
>><br>
>> My first problem was figuring out how to start yt at all. I went to the quickstart guide, but all it told me to do was run a bunch of ipython notebooks. Nowhere did it mention that yt can just be imported into python like any other module and run from there, which would have saved me a lot of time and trouble. I don't know how to run an ipython notebook; I've never used them before. I eventually figured out how to create one, but then I had to access it remotely. All my data resides on the filesystem of the supercomputer where it was calculated. It's not feasible to fetch it to my local machine, especially not when I'm generating new data much faster than I could transfer it. So analysis needs to run on the viz node. Eventually I got a notebook to connect (needed to set up an ssh tunnel apparently) but it was really annoying to work through. I may be a programmer by profession, but I don't often deal with web stuff, and all of this setup is badly-explained when it's explai<br>
 n<br>
>  ed<br>
>>   at all<br>
>>  on the relevant websites. Like I said, this could have been avoided if the quickstart guide had ever mentioned that I could just import it and work with it like any other python module instead of diving straight into notebooks.<br>
>><br>
>> I got lost for a while in the fact that there seems to be two sets of documentation for ipython notebooks - ipython, but then jupyter? All the recent documentation on notebooks is written for jupyter, but that's not installed on my viz node and yt's docs don't say anything about it. So that also confused the heck out of me for a little while.<br>
>><br>
>> The cookbook recipes are also real confusing if you're working with 2D data. Nearly everything is written assuming you have a 3D dataset. I had to mess around a bit before I figured out that you could do a SlicePlot with a 2D dataset as long as you specify a slice axis that does not, technically, exist. ProjectionPlot is really what should be used for 2D data but the name makes it non-obvious that that's what you want.<br>
>><br>
>> yt itself is great and I'd really like to use it. I understand that a lot of the devs and members of the community work with things like bitbucket and ipython notebooks on a daily basis, but I spend most of my time tackling 30-year-old Fortran and I'm certainly not the only one. I have enough trouble just getting these simulations to run in the first place; there's no room in my workflow for me to devote large chunks of time to unraveling the visualization software. Programs like VisIt and EnSuite might be balky and obscenely expensive, but in general you can turn them on, click a button, open your data, and get a simple picture in a few minutes. Please overhaul the "quickstart" guides so that it's easier for someone like me who has python and matplotlib experience but no notebook experience to just turn the dang thing on and make a picture with a minimum of fuss.<br>
>><br>
>><br>
>> _______________________________________________<br>
>> yt-dev mailing list<br>
>> <a href="mailto:yt-dev@lists.spacepope.org" target="_blank">yt-dev@lists.spacepope.org</a><br>
>> <a href="http://lists.spacepope.org/listinfo.cgi/yt-dev-spacepope.org" rel="noreferrer" target="_blank">http://lists.spacepope.org/listinfo.cgi/yt-dev-spacepope.org</a><br>
> _______________________________________________<br>
> yt-dev mailing list<br>
> <a href="mailto:yt-dev@lists.spacepope.org" target="_blank">yt-dev@lists.spacepope.org</a><br>
> <a href="http://lists.spacepope.org/listinfo.cgi/yt-dev-spacepope.org" rel="noreferrer" target="_blank">http://lists.spacepope.org/listinfo.cgi/yt-dev-spacepope.org</a><br>
<br>
<br>
<br>
</div></div><span><font color="#888888">--<br>
------------------------------------------------------------------------<br>
Joseph Smidt <<a href="mailto:josephsmidt@gmail.com" target="_blank">josephsmidt@gmail.com</a>><br>
<br>
Theoretical Division<br>
P.O. Box 1663, Mail Stop B283<br>
Los Alamos, NM 87545<br>
Office: <a href="tel:505-665-9752" value="+15056659752" target="_blank">505-665-9752</a><br>
Fax:    <a href="tel:505-667-1931" value="+15056671931" target="_blank">505-667-1931</a><br>
</font></span><div><div>_______________________________________________<br>
yt-dev mailing list<br>
<a href="mailto:yt-dev@lists.spacepope.org" target="_blank">yt-dev@lists.spacepope.org</a><br>
<a href="http://lists.spacepope.org/listinfo.cgi/yt-dev-spacepope.org" rel="noreferrer" target="_blank">http://lists.spacepope.org/listinfo.cgi/yt-dev-spacepope.org</a><br>
</div></div></blockquote></div></div></div><br></div></div>
</blockquote></div><br></div>