<html xmlns:v="urn:schemas-microsoft-com:vml" xmlns:o="urn:schemas-microsoft-com:office:office" xmlns:w="urn:schemas-microsoft-com:office:word" xmlns:m="http://schemas.microsoft.com/office/2004/12/omml" xmlns="http://www.w3.org/TR/REC-html40">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<meta name="Generator" content="Microsoft Word 14 (filtered medium)">
<style><!--
/* Font Definitions */
@font-face
{font-family:Calibri;
panose-1:2 15 5 2 2 2 4 3 2 4;}
@font-face
{font-family:Tahoma;
panose-1:2 11 6 4 3 5 4 4 2 4;}
@font-face
{font-family:Consolas;
panose-1:2 11 6 9 2 2 4 3 2 4;}
/* Style Definitions */
p.MsoNormal, li.MsoNormal, div.MsoNormal
{margin:0cm;
margin-bottom:.0001pt;
font-size:12.0pt;
font-family:"Times New Roman","serif";}
a:link, span.MsoHyperlink
{mso-style-priority:99;
color:blue;
text-decoration:underline;}
a:visited, span.MsoHyperlinkFollowed
{mso-style-priority:99;
color:purple;
text-decoration:underline;}
pre
{mso-style-priority:99;
mso-style-link:"HTML Preformatted Char";
margin:0cm;
margin-bottom:.0001pt;
font-size:10.0pt;
font-family:"Courier New";}
p.MsoAcetate, li.MsoAcetate, div.MsoAcetate
{mso-style-priority:99;
mso-style-link:"Balloon Text Char";
margin:0cm;
margin-bottom:.0001pt;
font-size:8.0pt;
font-family:"Tahoma","sans-serif";}
span.HTMLPreformattedChar
{mso-style-name:"HTML Preformatted Char";
mso-style-priority:99;
mso-style-link:"HTML Preformatted";
font-family:Consolas;
mso-fareast-language:EN-GB;}
span.BalloonTextChar
{mso-style-name:"Balloon Text Char";
mso-style-priority:99;
mso-style-link:"Balloon Text";
font-family:"Tahoma","sans-serif";
mso-fareast-language:EN-GB;}
span.EmailStyle22
{mso-style-type:personal-reply;
font-family:"Calibri","sans-serif";
color:windowtext;}
.MsoChpDefault
{mso-style-type:export-only;
font-family:"Calibri","sans-serif";
mso-fareast-language:EN-US;}
@page WordSection1
{size:612.0pt 792.0pt;
margin:72.0pt 72.0pt 72.0pt 72.0pt;}
div.WordSection1
{page:WordSection1;}
--></style><!--[if gte mso 9]><xml>
<o:shapedefaults v:ext="edit" spidmax="1026" />
</xml><![endif]--><!--[if gte mso 9]><xml>
<o:shapelayout v:ext="edit">
<o:idmap v:ext="edit" data="1" />
</o:shapelayout></xml><![endif]-->
</head>
<body lang="EN-GB" link="blue" vlink="purple">
<div class="WordSection1">
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif"">Vaclav, thank you for your comprehensive answer.<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif""><o:p> </o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif"">You answered to my original question with ‘in the module tree under search modules’, thank you! A thought: is this explained anywhere in the GRASS documentation for addons?
If not, how do I request that this information is included? Its rather fundamental and it would save this mailing list being hassled but such trivialities.<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif""><o:p> </o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif"">Probably I should have put the commands that I had tried previously so that it was clear that I’m not a total numpty. I understood how to use the manual, that I have to define
the DEM (and what a DEM is), and that there are 4 other required parameter which have defaults (and what these parameters are, and that I need to experiment to find the most useful for my application but thank you for explaining). In fact I have even studied
to quite some detail the published work pertaining to this addon. <o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif""><o:p> </o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif"">What I couldn’t fathom was how to tell GRASS where to put the output, this is clearer now I understand that <name> specifically pertains to names of maps (although I still
am not sure how I tell which are input maps and which are output maps). From your response I have used the additional parameter ‘forms=<name>’ and this worked. I even worked out that I need to add the new map layer to the layer tree to display it ;-) .<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif""><o:p> </o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif"">It took several tests to learn that ‘</span><span style="font-size:11.0pt;font-family:"Calibri","sans-serif"">forms</span><span style="font-size:11.0pt;font-family:"Calibri","sans-serif"">=name:
Most common geomorphic forms’ does not mean that I have to give the <i>name</i> of one of the 10 popular land forms but rather than the output is called <name> and contains the 10 most popular land forms. I had a similar misunderstanding of the definitions
for other parameters. <o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif""><o:p> </o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif"">I hope I am now correct in understanding that this function also has a further required parameter which needs to be one of <forms,
</span><span style="font-size:11.0pt;font-family:"Calibri","sans-serif"">ternary</span><span style="font-size:11.0pt;font-family:"Calibri","sans-serif"">, positive, negative, intensity, exposition, range, variance, elongation, azimuth, extend, width> and that
the values for these are the name of the output raster. I believe this could be much clearer in the documentation.
<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif""><o:p> </o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif"">Thank you also for your hint for getting the GUI using the command prompt – very useful!<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif""><o:p> </o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif"">Izzy<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif""><o:p> </o:p></span></p>
<p class="MsoNormal"><b><span lang="EN-US" style="font-size:10.0pt;font-family:"Tahoma","sans-serif"">From:</span></b><span lang="EN-US" style="font-size:10.0pt;font-family:"Tahoma","sans-serif""> Vaclav Petras [mailto:wenzeslaus@gmail.com]
<br>
<b>Sent:</b> 12 June 2014 15:35<br>
<b>To:</b> Isabel Sargent<br>
<b>Cc:</b> Micha Silver; grass-user@lists.osgeo.org<br>
<b>Subject:</b> Re: [GRASS-user] Newbie Q - how do I use addons?<o:p></o:p></span></p>
<p class="MsoNormal"><o:p> </o:p></p>
<div>
<p class="MsoNormal"><o:p> </o:p></p>
<div>
<div>
<p class="MsoNormal" style="margin-bottom:12.0pt"><o:p> </o:p></p>
<div>
<p class="MsoNormal">On Thu, Jun 12, 2014 at 9:16 AM, Isabel Sargent <<a href="mailto:Isabel.Sargent@ordnancesurvey.co.uk" target="_blank">Isabel.Sargent@ordnancesurvey.co.uk</a>> wrote:<o:p></o:p></p>
<div>
<div>
<p class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif"">Thank you for such a prompt response. I had read through the manual pages online (though I couldn’t get the man
command to work, perhaps because I’m using windows?). Those last 4 required fields have defaults, so in my question I was assuming that I didn’t need to explicitly set them. Even if I do set them I get the error requiring an output. I don’t think this in itself
is a r.geomorphon issue, there is probably a standard way of defining an output (neither | or > work). I’m sure there must be examples on how to do this somewhere, I just can’t find them.</span><o:p></o:p></p>
<p class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif""> </span><o:p></o:p></p>
</div>
</div>
<div>
<p class="MsoNormal" style="margin-bottom:12.0pt">r.geomorphon should work on MS Windows.<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal" style="margin-bottom:12.0pt">In manual page (<a href="http://grass.osgeo.org/grass70/manuals/addons/r.geomorphon.html">http://grass.osgeo.org/grass70/manuals/addons/r.geomorphon.html</a>) I can see 5 required parameters (options):<o:p></o:p></p>
<p class="MsoNormal"><b>dem</b>=<em>name</em> <b>[required]</b><o:p></o:p></p>
<p class="MsoNormal" style="margin-left:36.0pt">Input dem<o:p></o:p></p>
<p class="MsoNormal"><b>search</b>=<em>integer</em> <b>[required]</b><o:p></o:p></p>
<p class="MsoNormal" style="margin-left:36.0pt">Outer search radius<o:p></o:p></p>
<p class="MsoNormal" style="margin-left:36.0pt">Default: <em>3</em><o:p></o:p></p>
<p class="MsoNormal"><b>skip</b>=<em>integer</em> <b>[required]</b><o:p></o:p></p>
<p class="MsoNormal" style="margin-left:36.0pt">Inner search radius<o:p></o:p></p>
<p class="MsoNormal" style="margin-left:36.0pt">Default: <em>0</em><o:p></o:p></p>
<p class="MsoNormal"><b>flat</b>=<em>float</em> <b>[required]</b><o:p></o:p></p>
<p class="MsoNormal" style="margin-left:36.0pt">Flatenss treshold (degrees)<o:p></o:p></p>
<p class="MsoNormal" style="margin-left:36.0pt">Default: <em>1</em><o:p></o:p></p>
<p class="MsoNormal"><b>dist</b>=<em>float</em> <b>[required]</b><o:p></o:p></p>
<p class="MsoNormal" style="margin-left:36.0pt">Flatenss distance, zero for none<o:p></o:p></p>
<p class="MsoNormal" style="margin-left:36.0pt">Default: <em>0</em><o:p></o:p></p>
<p class="MsoNormal" style="margin-bottom:12.0pt">Four have default but <b>dem</b> does not. This is the elevation raster map, your input. You should also specify output, this is option
<b>forms</b>, this will be the name of newly created raster map containing identified forms. This is what the message
<i>'ERROR: At least one output is required'</i> was telling you, it wanted you to specify one of the outputs. (The interface does not follow GRASS naming conventions, that's one of the reasons why it is an addon. This might be improved in the future.)<br>
<br>
Note that to get really nice output from r.geomorphon you have to play with the parameters such as search, skip, flat and dist a little bit.<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal">| and > are linux/unix command line features which allows you to direct standard input and output of the programs. This is applicable to some of the GRASS modules but most of them outputs "grass maps" (raster or vector) and there are specified
by setting certain options to a name of the raster map. This is what manual page will tell you.<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"> <o:p></o:p></p>
</div>
<blockquote style="border:none;border-left:solid #CCCCCC 1.0pt;padding:0cm 0cm 0cm 6.0pt;margin-left:4.8pt;margin-right:0cm">
<div>
<div>
<p class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif"">Am I right in expecting to be able to find installed addons use the GUI? If so, where will I find them? If not,
how do I define an output at the command prompt?</span><o:p></o:p></p>
</div>
</div>
</blockquote>
<div>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
<div>
<p class="MsoNormal" style="margin-bottom:12.0pt">Yes and no. They are not in menu (to keep it short) but installed addons are in the module tree in Search modules tab (3rd tab by default in layer manager). You have to restart GRASS (or just GUI if you use
command line and know g.gui command) to get the updated list.<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal">You can always type r.geomorphon to Command console in GUI and you will get the dialog to fill parameters (including inputs and outputs) for r.geomorphon. This works for every command, form addons or standard one.<o:p></o:p></p>
</div>
<p class="MsoNormal"><o:p> </o:p></p>
<div>
<p class="MsoNormal" style="margin-bottom:12.0pt">Let us know if you have any further problems.<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal">Vaclav<o:p></o:p></p>
</div>
<blockquote style="border:none;border-left:solid #CCCCCC 1.0pt;padding:0cm 0cm 0cm 6.0pt;margin-left:4.8pt;margin-right:0cm">
<div>
<div>
<p class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif""> </span><o:p></o:p></p>
<div>
<p class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif"">Izzy</span><o:p></o:p></p>
</div>
<p class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif""> </span><o:p></o:p></p>
<div>
<div style="border:none;border-top:solid windowtext 1.0pt;padding:3.0pt 0cm 0cm 0cm;border-color:-moz-use-text-color -moz-use-text-color">
<p class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto"><b><span lang="EN-US" style="font-size:10.0pt;font-family:"Tahoma","sans-serif"">From:</span></b><span lang="EN-US" style="font-size:10.0pt;font-family:"Tahoma","sans-serif""> Micha
Silver [mailto:<a href="mailto:micha@arava.co.il" target="_blank">micha@arava.co.il</a>]
<br>
<b>Sent:</b> 12 June 2014 13:56<br>
<b>To:</b> Isabel Sargent; <a href="mailto:grass-user@lists.osgeo.org" target="_blank">
grass-user@lists.osgeo.org</a><br>
<b>Subject:</b> Re: [GRASS-user] Newbie Q - how do I use addons?</span><o:p></o:p></p>
</div>
</div>
<div>
<p class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto"> <o:p></o:p></p>
<div>
<p class="MsoNormal" style="mso-margin-top-alt:auto;mso-margin-bottom-alt:auto">On 12/06/2014 15:20, Isabel Sargent wrote:<o:p></o:p></p>
</div>
<blockquote style="margin-top:5.0pt;margin-bottom:5.0pt">
<pre>Sorry, the answer to my question must be somewhere but I have been searching for 90 minutes and have found nothing, please humour me.<o:p></o:p></pre>
<pre> <o:p></o:p></pre>
<pre>I GRASS 7.0.0BETA2 installed on Windows 7. All looks fine. I have installed the r.geomorphon addon without any errors and have checked in the installed extensions manager that it appears to be installed. My problem is, what now?<o:p></o:p></pre>
<pre> <o:p></o:p></pre>
<pre>I can't find r.geomorphon in any of the lists in the gui. If I use command line, I cannot work out how to tell GRASS where to put the output (do I have to pipe somewhere? How should I do this?). Command line is not happy with simply 'r.geomorphon dem=<name>' => 'ERROR: At least one output is required'<o:p></o:p></pre>
</blockquote>
<p class="MsoNormal" style="mso-margin-top-alt:auto;margin-bottom:12.0pt">I'm not familiar with the addon, but typing "r.geomorphon help " in the command line gives a brief help message. And "man r.geomorphon" opens the whole manual page.<br>
The required parameters are "dem" (input) and "search", "skip", "flat" and "dist" (numeric parameters).<br>
<br>
<o:p></o:p></p>
<pre> <o:p></o:p></pre>
<pre>Please just point me to some examples and I'll stop being so annoying!<o:p></o:p></pre>
<pre> <o:p></o:p></pre>
<pre>Izzy<o:p></o:p></pre>
<pre> <o:p></o:p></pre>
</div>
<pre>_______________________________________________<o:p></o:p></pre>
<div>
<pre>grass-user mailing list<o:p></o:p></pre>
<pre><a href="mailto:grass-user@lists.osgeo.org" target="_blank">grass-user@lists.osgeo.org</a><o:p></o:p></pre>
<pre><a href="http://lists.osgeo.org/mailman/listinfo/grass-user" target="_blank">http://lists.osgeo.org/mailman/listinfo/grass-user</a><o:p></o:p></pre>
<pre> <o:p></o:p></pre>
<pre>This mail was received via Mail-SeCure System.<o:p></o:p></pre>
<pre> <o:p></o:p></pre>
<pre> <o:p></o:p></pre>
<p class="MsoNormal" style="mso-margin-top-alt:auto;margin-bottom:12.0pt"><br>
<br>
<o:p></o:p></p>
<pre>-- <o:p></o:p></pre>
<pre>Micha Silver<o:p></o:p></pre>
<pre>GIS Consulting<o:p></o:p></pre>
<pre>052-3665918<o:p></o:p></pre>
<pre><a href="http://www.surfaces.co.il" target="_blank">http://www.surfaces.co.il</a><o:p></o:p></pre>
</div>
</div>
</div>
<div>
<div>
<pre>This email is only intended for the person to whom it is addressed and may contain confidential information. If you have received this email in error, please notify the sender and delete this email which must not be copied, distributed or disclosed to any other person.<o:p></o:p></pre>
<pre><o:p> </o:p></pre>
<pre>Unless stated otherwise, the contents of this email are personal to the writer and do not represent the official view of Ordnance Survey. Nor can any contract be formed on Ordnance Survey's behalf via email. We reserve the right to monitor emails and attachments without prior notice.<o:p></o:p></pre>
<pre><o:p> </o:p></pre>
<pre>Thank you for your cooperation.<o:p></o:p></pre>
<pre><o:p> </o:p></pre>
<pre>Ordnance Survey<o:p></o:p></pre>
<pre>Adanac Drive<o:p></o:p></pre>
<pre>Southampton SO16 0AS<o:p></o:p></pre>
<pre>Tel: 08456 050505<o:p></o:p></pre>
<pre><a href="http://www.ordnancesurvey.co.uk" target="_blank">http://www.ordnancesurvey.co.uk</a><o:p></o:p></pre>
<pre><o:p> </o:p></pre>
</div>
</div>
<p class="MsoNormal"><br>
_______________________________________________<br>
grass-user mailing list<br>
<a href="mailto:grass-user@lists.osgeo.org">grass-user@lists.osgeo.org</a><br>
<a href="http://lists.osgeo.org/mailman/listinfo/grass-user" target="_blank">http://lists.osgeo.org/mailman/listinfo/grass-user</a><o:p></o:p></p>
</blockquote>
</div>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
</div>
</div>
</div>
</body>
</html>
<pre>This email is only intended for the person to whom it is addressed and may contain confidential information. If you have received this email in error, please notify the sender and delete this email which must not be copied, distributed or disclosed to any other person.
Unless stated otherwise, the contents of this email are personal to the writer and do not represent the official view of Ordnance Survey. Nor can any contract be formed on Ordnance Survey's behalf via email. We reserve the right to monitor emails and attachments without prior notice.
Thank you for your cooperation.
Ordnance Survey
Adanac Drive
Southampton SO16 0AS
Tel: 08456 050505
http://www.ordnancesurvey.co.uk