On 01/20/2012 07:23 AM, Matthew Kenworthy wrote:
There's been some traffic about the status and location of the PDL
Book, so this is an attempt to summarise what's been going on:
The PDL Book is in a git repository, which you can currently look at
with your browser at:
http://pdl.git.sourceforge.net/git/gitweb.cgi?p=pdl/pdl-book;a=tree
The top level of the repository contains the file 00README.pod, which
gives more details on how to get a local copy, and how to get write
access and contribute to the Book. Please read this through to get a
good idea of what's going on:
http://pdl.git.sourceforge.net/git/gitweb.cgi?p=pdl/pdl-book;a=blob;f=00README.pod
...and the list of chapters and ordered section is in PDL/Book.pod:
http://pdl.git.sourceforge.net/git/gitweb.cgi?p=pdl/pdl-book;a=blob;f=PDL/Book.pod
Thanks to the efforts of several people on the Perldl list, we have a
relatively complete set of PODs and figures that make up a functional
book! The PDF version of the book is running to 159 pages with the
included figures. I'm not sure where I should put a live copy for
others to read... Chris, suggestions?
TODO list:
Import/write sections on TriD, Complex numbers, Threading, Transform,
Pthreads, Proj. Do we want a chapter on Proj?
Proofread the chapters and check that the examples work, and fixing
many links in the docs.
Work out directory structure that is suitable for PDL distribution and
for others to contribute.
My goal is to start reading the chapters and cleaning them up into a
consistent flowing book. If we stopped additions *right now*, we then
have a minimally useful book. The rest is making sure that the
demonstration files are easily accessible for interested users.
Thoughts?
Matt
Just went through PDL::Book::FirstSteps and found some stuff that are
candidates to be fixed:
* In "Alright let's do something" section, second paragraph 'editting'
should be 'editing'
* In the stand-alone script example for spiral graph there should be a
'use PDL::Graphics::PGPLOT;' after 'use PDL;'
* In "Measuring the brightness of M51" - first two pdl shell examples
start 'pdl>', maybe take those out for consistency?
* In "Twinkle, twinkle, little star":
** description of '$section = $gal(337:357,178:198);' says range is 327
to 367 and 168 and 208. Is that correct? Maybe I'm not understanding
NiceSlice very well ...
** in example to get the FWHM is has 'print $peak, $fwhm, $background;'
- it should probably be 'p $peak ...' since print doesn't put spaces
between the numbers
** In the fake star script I had to add 'use PDL::NiceSlice;' otherwise
I got an error that would likely confuse new PDL users
* The description of the figures don't start numbering them until 1.6.
Maybe number them all?
* May also want to mention about the aspect ratio before displaying
images. For me, using a fresh install, the images were stretched wider
than the examples shown. Might cause confusion for some beginners.
Other than those, everything worked as expected. I tried everything in
pdl2 and had no issues. I'll continue proofreading.
Mike
_______________________________________________
Perldl mailing list
[email protected]
http://mailman.jach.hawaii.edu/mailman/listinfo/perldl
