Comes

Author: joa-quim

documentation/common_opts/common_opts.md

@@ -106,19 +106,22 @@ The optional *annot_unit* indicates the unit of the *stride* and can be any of t
 Note for geographic axes **m** and **s** instead mean arc minutes and arc seconds.
 All entities that are language-specific are under control by [GMT\_LANGUAGE](http://docs.generic-mapping-tools.org/latest/gmt.conf.html#gmt-language). 
 
-For custom annotations and intervals, let *intervals* be given as *custom="intfile"*, where
+For custom annotations and intervals, let *intervals* be given as **custom**=*"intfile"*, where
 *intfile* contains any number of records with *coord type* [*label*]. Here, *type* is one or more
 letters from **a** or **i**, **f**, and **g**. For **a** or **i** you must supply a *label* that will
-be plotted at the *coord* location.
+be plotted at the *coord* location. The **custom** option can also be used giving it a NamedTuple
+argument. For example **xaxis=(custom=(pos=[1,2,3], label=(:Aa, :Bb, :Cc)), angle=45)** (and we could have
+used _type_, as described above, intead of _label_). NOTE, the _angle_ keyword can only be used on `x` axis.
 
 A simpler way of controling the ticks and annotations with custom settings is to use the **xticks** option
-(same for **yticks** and **zticks**). Here, one give a tuple with annotations interval and labels. E.g.
-**xticks=(1:5, ["a", "b", "c", "d"])** where first element is an AbstractArray and second an array or tuple of
+(same for **yticks** and **zticks**). Here, one give a tuple with labels, annotations interval, and angle of annotations.
+Of these, only the _labels_ is mandatory, and the angle (a single value) can only be used for **xticks**. E.g.
+**xticks=(1:5, ["a", "b", "c", "d"], 90)** where first element is an AbstractArray and second an array or tuple of
 strings or symbols. The more elaborate effect described above for the *custom* options is achieved here by
 escaping the **a** or **i**, **f**, and **g** codes with a forward slash in a text string. Example:
 **xticks=(1:5, ["a", "f", "/ag e", "f", "/ag @~p@~"])**. Here "/ag e" means annotate the third value with *e*
 and add a grid line. These *x|y|zticks* options work only for the primary axes. To change the secondary use
-the *customtics* form. *E.g.* **xaxis2=(customticks(...),)**. Note that the *ticks* keyword is already taken
+the *customticks* form. *E.g.* **xaxis2=(customticks(...),)**. Note that the *ticks* keyword is already taken
 to control the ticks interval hence the need to use a different one (*customticks*).
 
 For non-geographical projections: Give negative scale or figure sizes to change the direction of increasing

documentation/modules/makecpt.md

@@ -214,7 +214,16 @@ imshow(makecpt(cmap=(:red,:green,:blue), range=[0,100,300,1000], no_bg=true), ho
 ```
 \end{examplefig}
 
-To make a continuous CPT from white to blue as z goes from 3 to 10, try
+To make a discrete CPT from white to blue as z goes from 3 to 10, try
+
+\begin{examplefig}{}
+```julia
+using GMT
+imshow(makecpt(cmap="white,blue", range=(3,10)), continuous=true, horizontal=true)
+```
+\end{examplefig}
+
+And to get a continuous CPT, use the option `continuous=true`.
 
 \begin{examplefig}{}
 ```julia
@@ -223,6 +232,7 @@ imshow(makecpt(cmap="white,blue", range=(3,10)), horizontal=true)
 ```
 \end{examplefig}
 
+
 To make a wrapped (cyclic) CPT from the turbo table over the interval 0 to 500, i.e., the color will be wrapped every 500
 z-units so that we always get a color regardless of the *z* value, try
 

documentation/modules/spectrum1d.md

@@ -18,21 +18,21 @@ The output has 3 columns: f or w, p, and e. f or w is the frequency or wavelengt
 the one standard deviation error bar size. If the **output** option is used, up to eight files are
 created; otherwise only one (xpower) is written.
 
-*name_stem*.xpower
+- *name_stem*.xpower\
     Power spectral density of *X*\ (*t*). Units of X \* X \* *dt*.
-*name_stem*.ypower
+- *name_stem*.ypower\
     Power spectral density of *Y*\ (*t*). Units of Y \* Y \* *dt*.
-*name_stem*.cpower
+- *name_stem*.cpower\
     Power spectral density of the coherent output. Units same as ypower.
-*name_stem*.npower
+- *name_stem*.npower\
     Power spectral density of the noise output. Units same as ypower.
-*name_stem*.gain
+- *name_stem*.gain\
     Gain spectrum, or modulus of the transfer function. Units of (Y / X).
-*name_stem*.phase
+- *name_stem*.phase\
     Phase spectrum, or phase of the transfer function. Units are radians.
-*name_stem*.admit
+- *name_stem*.admit\
     Admittance spectrum, or real part of the transfer function. Units of (Y / X).
-*name_stem*.coh
+- *name_stem*.coh\
     (Squared) coherency spectrum, or linear correlation coefficient as a
     function of frequency. Dimensionless number in [0, 1]. The
     Signal-to-Noise-Ratio (SNR) is coh / (1 - coh). SNR = 1 when coh = 0.5.
@@ -68,7 +68,6 @@ Optional Arguments
     coherent output and the noise output are uncorrelated. Optionally specify up to 8 directives from the set
     refered above in any order to create only those output files instead of the default [all]. Use in alternatively
     a string made of the `acgnopxy` characters, or the expanded version that uses the keywords.
- 
     - **a** or `admitt=true`: Admittance spectrum, or real part of the transfer function.
     - **c** or `cpower=true`: Power spectral density of the coherent output.
     - **g** or `gain=true`: Gain spectrum, or modulus of the transfer function.

documentation/utilities/pcolor.md

@@ -90,6 +90,16 @@ pcolor(G.x, G.y, G.z, labels=2, font=(angle=45, font=(5,:red)), show=1)
 ```
 \end{examplefig}
 
+Display a Pearson's correlation matrix
+
+\begin{examplefig}{}
+```julia
+using GMT
+
+pcolor(GMT.cor(rand(4,4)), labels=:y, colorbar=1, show=true)
+```
+\end{examplefig}
+
 An irregular grid
 
 \begin{examplefig}{}