<!--
(C) Copyright 1996-2016 ECMWF.
This software is licensed under the terms of the Apache Licence Version 2.0
which can be obtained at http://www.apache.org/licenses/LICENSE-2.0.
In applying this licence, ECMWF does not waive the privileges and immunities
granted to it by virtue of its status as an intergovernmental organisation nor
does it submit to any jurisdiction.
-->
<magics>
	<class xmltag="wind"
		name="Wind"
		metview="MWIND"
		directory="visualisers"
		prefix="wind"
		action="pwind">
		<documentation>Wind plotting facilities allow users to plot wind fields as either arrows or flags.</documentation>
		<parameter member="type"
			to="WindPlotting"
			default="arrows"
			from="string"
			name="wind_field_type">
			<documentation>Method of wind field plotting</documentation>
			<release>Basic implementation in 0.6</release>
			<option xml="flags" fortran="flags" include="FlagPlotting.h" name="FlagPlotting"></option>
			<option xml="arrows" fortran="arrows" include="ArrowPlotting.h" name="ArrowPlotting"></option>
			<option fortran="streamlines" include="Streamlines.h" name="Streamlines"></option>
		</parameter>
		<parameter from="string"
			name="wind_thinning_method"
			visible="false"
			default="data"
			member="thinning_method"
			to="string"
			values="data/user">
			<documentation>Method to control the thinning:
         data : wind_thinning_factor will determine the frequency as before
         user : wind_thining_factor will determine the minimal distance in user coordinates betvween 2 winds.
         the default is "data" for backward compatibility.</documentation>
		</parameter>
		<parameter member="thinning_factor"
			to="float"
			default="2.0"
			from="float"
			name="wind_thinning_factor">
			<documentation>Controls the actual number of wind arrows or flags plotted. See main text for explanation. Needs to 1.0 or larger.</documentation>
		</parameter>
		<parameter name='wind_thinning_debug'
			from='string'
			to='bool'
			member='thinning_debug'
			default='off'
			visible='false'>
			<documentation>Add Position requiered for thiniing [ Debug mode only]</documentation>
		</parameter>
		<parameter from="string"
			name="wind_automatic_setting"
			default="off"
			member="setting"
			to="string"
			values="off/style_name/ecmwf">
			<documentation>Turn the automatic setting of contouring attributes</documentation>
			<unset name="wind_automatic_library_path" value="off"></unset>
			<set name="wind_style_name" value="style_name"></set>
		</parameter>
		<parameter from="string"
			name="wind_style_name"
			default=""
			member="predefined"
			to="string">
			<documentation>Use of a predeined setting</documentation>
		</parameter>
		<parameter from="string"
			name="wind_automatic_library_path"
			visible="off"
			python="off"
			default=""
			member="library_path"
			to="string">
			<documentation>Users can give their own directory to setup the automatic library of contours</documentation>
		</parameter>

	</class>
</magics>
