====== The climate editor ======

//Please note: //This tutorial is a technical guide to using the climate editor window. If you want a guide on how to make or modify a climate, please see [[bundywiki>tutorials:l3dt:newclimate|this tutorial]].

The //climate editor// window, shown below, is opened using the '//Edit//' button in the [[l3dt:userguide:climates:manager|climate manager]] window. 

{{ l3dt:userguide:dialogs:clieditor.png?250 }}

This dialog box has a //lot// of controls, which I've broken up into the loose categories of [[#names]], [[#some buttons]], [[#some more buttons]], and [[#one last button]].

===== Names =====

  * //Climate name// --- The display name for this climate, as it will appear in the [[l3dt:userguide:newmap:design_inflate#the_design_map_parameters_wizard_pane|design map parameters]] wizard (and elsewhere).
  * //File name// --- The full pathname of the [[l3dt:formats:specs:cli.xml|climate file]] (.cli.xml) that will store the settings for this climate. Clicking on the '...' button opens a standard Windows file dialog, with which you can browse for the file.
  * //Author name// --- The name of the author of this climate (optional).

===== Some buttons =====

==== Display colour ==== 

The '//display colour//' button opens a standard Windows colour dialog, with which you may choose the colour that will represent this climate in the design map display (see [[l3dt:userguide:view:schemes:dm|schemes user guide]]). This colour has no effect on anything else whatsoever.


==== Global params ====

The '//Global Params//' button opens a dialog-box (shown below) with which you may edit the whole-climate modifiers (see [[l3dt:algorithms:cli:climate#global_params|algorithms page]]). These values, which include //grad// (gradient), //curv// (curvature), //water//, and //salin// (water salinity) modulate the the coefficients for each of the individual land types in the climate when the [[l3dt:userguide:ops:am#Generating the attributes map|attributes map is calculated]]. In general, these values should be left at 1.0, but you may need to vary them slightly if, for example, you find that the whole climate is //too// sensitive to salinity (eg. set //Salin// to 0.8 to reduce sensitivity).

{{ l3dt:userguide:climates:globals.png }}

To edit a value, double-click on the variable name.


==== Author's notes ====

The '//author's notes//' button opens up a text-editor (show below), with which authors may write a short (or long) description of their climates. If you intend to share your climate with other users, this description can be used to inform those users of what the climate will look like, and whether there are any tricks involved in using it. These notes may be read from the '//notes//' button in the [[l3dt:userguide:newmap:design_inflate#the_design_map_parameters_wizard_pane|design map parameters]] wizard (next to the '//climate//' drop-down list).

{{ l3dt:userguide:climates:authnotes.png }}


===== Some more buttons =====

==== Create ====

Create an empty land type and open the [[l3dt:userguide:climates:ltedit|land type editor interface]].

==== Copy ====

Create a clone of the selected land type, and open the [[l3dt:userguide:climates:ltedit|land type editor interface]].


==== Edit ====

Open the [[l3dt:userguide:climates:ltedit|land type editor]] window. Note that double-clicking on a land type in the list is equivalent to clicking on the '//edit//' button.

==== Rename ====

Change the display-name of a land type.

==== Disable ====

Mark the selected land type to be ignored when calculating the attributes map. Disabled land types are displayed in this dialog as within a C-style block comment (e.g. '3: /* Underwater rock (sea) */').

==== Delete ====

Delete a land type from the climate's list.

==== 'Up' and 'Dn' ====

These buttons allow users to re-sort the land types in the climate's list. Note that changing the order of land types will require all attributes maps that use this climate to be re-calculated. //Don't use this unless you mean it!//


===== One last button =====

==== Save ==== 

Write the climate to the file specified by //climate filename//. This is otherwise done automatically when you close the climate editor with '//OK//', and then close the [[l3dt:userguide:climates:manager|climate manager]] with '//OK//'.