summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/pgf-spectra/pgf-spectraManual.tex
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2023-04-26 19:33:16 +0000
committerKarl Berry <karl@freefriends.org>2023-04-26 19:33:16 +0000
commit13ae8787f9d33680dd86fe338284693195b642d2 (patch)
tree9b97c9b002a25670152b17a359e71b5200fc050c /Master/texmf-dist/doc/latex/pgf-spectra/pgf-spectraManual.tex
parent5b93ed43d5e09c815010991673125162506b6de6 (diff)
pgf-spectra (26apr23)
git-svn-id: svn://tug.org/texlive/trunk@66946 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/pgf-spectra/pgf-spectraManual.tex')
-rw-r--r--Master/texmf-dist/doc/latex/pgf-spectra/pgf-spectraManual.tex774
1 files changed, 550 insertions, 224 deletions
diff --git a/Master/texmf-dist/doc/latex/pgf-spectra/pgf-spectraManual.tex b/Master/texmf-dist/doc/latex/pgf-spectra/pgf-spectraManual.tex
index 4dcf3764750..c76b081853d 100644
--- a/Master/texmf-dist/doc/latex/pgf-spectra/pgf-spectraManual.tex
+++ b/Master/texmf-dist/doc/latex/pgf-spectra/pgf-spectraManual.tex
@@ -6,7 +6,8 @@
% with the preview package...
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\documentclass[a4paper,10pt,oneside,openany,fleqno]{article}
-\usepackage{pgf-spectra}
+\usepackage[LSE]{pgf-spectra}
+\usepgfspectralibrary{data,pgfplots,rainbow,tempercolor}%
\usetikzlibrary{fadings}
%\usepackage{pgfplots}
%\usepgfplotslibrary{fillbetween}
@@ -19,14 +20,12 @@
\setlength{\parindent}{0pt}
\setlength{\oddsidemargin}{0pt}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-\def\version{2.2.0}%
-\def\minorversion{2.1.0}%
-\def\minorrevversion{2.1.1}%
-\def\minorrev{2.1.2}%
+\def\version{3.0.0}%
+\def\inversion#1{#1}%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\usepackage[pdfstartview={ },colorlinks=true, linkcolor=black!50!green, citecolor=gray, urlcolor=teal, hyperindex, plainpages=false,bookmarksopenlevel=1,bookmarksopen=true]{hyperref}%
\hypersetup{%Start options on pdf
-pdftitle = {Manual for pgf-spectra (v\version)},%
+pdftitle = {Manual for pgf-spectra (v\inversion{2.2.0})},%
pdfsubject = {Emission and absorption lines of the elements},%
pdfkeywords = {Draw the spectrum of elements in a simple way via pgf/TikZ environment. It's possible to draw a desired spectrum, continuous or discrete.},%
pdfauthor = {\textcopyright Hugo Gomes},%
@@ -69,15 +68,11 @@ pdfproducer = {pdfeTeX-1.\the\pdftexversion\pdftexrevision},
\makebox[\linewidth][c]{\tikz{%
\node[text width=.9\linewidth+.5cm,text justified,draw=blue!25!black,rounded corners=10pt,fill=blue!10] at (0,0) {\color{blue!25!black}
\begin{abstract}
-\noindent The purpose of this package is to draw the spectrum of elements in a simple way. It's based on the package \textit{pst-spectra}, but with some extra options. It relies on the pgf/\textrm{Ti\textit{k}Z} to draw the desired spectrum, continuous or discrete. As in \textit{pst-spectra} there are data available for the spectra of 98 elements and their ions. It also allows the user to draw a spectrum with their own personal data.
+\noindent The purpose of this package is to draw the spectrum of elements in a simple way. It's based on the package \textit{pst-spectra}, but with some extra options. It relies on pgf/\textrm{Ti\textit{k}Z} to draw the desired spectrum, continuous or discrete. As in \textit{pst-spectra} there is data available for the spectra of 98 elements and their ions. It also allows the user to draw a spectrum with their own custom data.
\\ [4pt]The lines data extends from Extreme UV to Near IR ($10\,nm\leq\lambda\leq4\hspace{.05pt}000\,nm$). \textit{See section \hyperlink{sec:data}{The lines data} below for more information.}
\\ [4pt]It is possible to redshift the lines of a spectrum, by directly entering the redshift value or the velocity and the angle to compute the redshift value (Doppler Redshift).
+\\ [4pt]Spectral lines data can be presented in a table or exported to a file.
\\ [4pt]This package also provides color conversion (correlated color temperature), shadings for use with \txttikz{} and/or \txtPGFPLOTS{} and color maps for use with \txtPGFPLOTS{}.
-%\\ [4pt]In version 2.0.0 the previous data of the visible region was extended to include lines from Extreme UV to Near IR ($10\,nm\leq\lambda\leq4\hspace{.05pt}000\,nm$). \textit{See section \hyperlink{sec:data}{The lines data} below for more information.}
-%\\ [4pt]Also in version 2.0.0 the possibility to redshift the lines of spectra was introduced, by entering directly the redshift value or the velocity and the angle to compute the redshift value (Doppler Redshift).
-%\\ [4pt]In version 2.1.0 a new color conversion (correlated color temperature), shadings for use with \txttikz{} and/or \txtPGFPLOTS{} and a color map for use with \txtPGFPLOTS{} were introduced.
-%\\ [4pt]In version 2.1.1 two new options are available in the shading for use with \txtPGFPLOTS{} (or \txttikz{}): shade begin and logarithmic (which builds the shading in a logarithmic scale).
-%\\ [4pt]In this release -- version 2.1.2 -- only a small fix was made (wrong char encoding in style definition file -- pgf-spectra.sty).
\\ [6pt]
\end{abstract}
};}}
@@ -102,6 +97,30 @@ pdfproducer = {pdfeTeX-1.\the\pdftexversion\pdftexrevision},
\vfill\vfill\vfill\newpage
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\section{What's new}
+\vspace{-32pt}\ \subsection*{}{\normalfont\large\bfseries\raisebox{1.25pt}{$\mathbf{\blacktriangleright}$}\ In version 3.0.0}%
+\addcontentsline{toc}{subsection}{In version 3.0.0}%
+\begin{itemize}
+\item In the \txtspec{} command, syntax for the key \textit{lines} has been updated: it is now possible to specify a continuous range using \textit{start wavelength to end wavelength}, for instance, lines=\{380 to 500\} or lines=\{380 to 500,633\} or lines=\{633,555,380 to 500\}.
+\item New keys for \txtspec:
+\begin{itemize}
+\item axis label
+\item axis label text
+\item axis label position
+\end{itemize}
+\item New command \txtcomname{usepgfspectralibrary} for loading pgf-spectra libraries.
+\item New library \textit{data} to load spectral lines data, display it in a table or export it to a file. This library provides the commands:
+\begin{itemize}
+\item\txtcomname{pgfspectradata} to load the desired data.
+\item\txtcomname{pgfspectratable} displays loaded data in a table.
+\item\txtcomname{pgfspectrawrite} write loaded data to a file.
+\end{itemize}
+\item Some commands from previous versions have been moved to new libraries:
+\begin{itemize}
+\item\txtcomname{pgfspectraplotshade} and \txtcomname{pgfspectraplotmap} moved to new library \textit{pgfplots}.
+\item\txtcomname{tempercolor} moved to new library \textit{tempercolor}.
+\item\txtcomname{pgfspectrarainbow} moved to new library \textit{rainbow}.
+\end{itemize}
+\end{itemize}
\vspace{-32pt}\ \subsection*{}{\normalfont\large\bfseries\raisebox{1.25pt}{$\mathbf{\blacktriangleright}$}\ In version 2.2.0}%
\addcontentsline{toc}{subsection}{In version 2.2.0}%
\begin{itemize}
@@ -227,24 +246,27 @@ with the following specific keys% \pgfspectraplotshade[options]{name}
\\ [12pt]\tikz{\node[text width=\linewidth-4mm,draw=purple,rounded corners=2pt,fill=black!10!purple!10,inner sep=2mm,text justified] {To use this data set load the package \pack{} without options: \\ [6pt]\large\color{purple}\verb|\usepackage{pgf-spectra}|\\ [6pt]\small\color{orange}\hfill Number of lines provided: 11980 (see file pgf-spectraDataNIST.pdf);}}
\newpage
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-\section{The commands}
-\hypertarget{sec:com}{The} four \textit{main} commands, those related with this package itself, are:
+\section{Commands overview}
+\hypertarget{sec:com}{The} \textit{main} commands, those always available, are:
\begin{itemize}
\item\txtspec{} or \txtspecopt[options list]
\item\textcolor{blue!50!black}{\textbackslash wlcolor\{}\textcolor{red!50!black}{wavelength}\textcolor{blue!50!black}{\}}
\item\txtspecstyle[options]
\item\txtspecstylereset
+\item\txtshade%\\ [4pt]\textit{This command can be used with }\txttikz{}.
+\item\txtcomname{usepgfspectralibrary}\lb\red{name(s)}\rb
\end{itemize}
-There are other four commands to use with \txttikz{} and/or \txtPGFPLOTS{}:
-\begin{itemize}
-\item\txttempercolor{Kelvin}
-\item\txtshade
-\item\txtplotshade
-\item\txtplotmap
-\end{itemize}
-And finally \textit{just for fun} a command that draws a rainbow:
+The commands available after loading libraries are:% to use with :
\begin{itemize}
-\item\txtrainbow
+\item\txtcomname{pgfspectradata}\lp\red{name of data set}\rp\lb\red{keys}\rb\hfill(\textit{data} library)
+\item\txtcomname{pgfspectratable}\lp\red{table options}\rp\lb\red{name(s) of data set(s)}\rb\hfill(\textit{data} library)
+\item\txtcomname{pgfspectrawrite}\lp\red{filename}\rp\lb\red{name(s) of data set(s)}\rb\hfill(\textit{data} library)
+\item\txtplotshade \hfill(\textit{pgfplots} library)
+%\\ [4pt]\textit{This command is to be used with }\txtPGFPLOTS{}.
+\item\txtplotmap \hfill(\textit{pgfplots} library)
+%\\ [4pt]\textit{This command is to be used with }\txtPGFPLOTS{}.
+\item\txttempercolor{Kelvin} \hfill(\textit{tempercolor} library)
+\item and finally \textit{just for fun} a command that draws a rainbow,\\ [4pt]\txtrainbow\hfill(\textit{rainbow} library)
\end{itemize}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\vspace{-32pt}\
@@ -273,8 +295,7 @@ And finally \textit{just for fun} a command that draws a rainbow:
}
}}
\\ [-6pt]\tikz{\draw[fill=black!20,draw=black!20,rounded corners=1pt] (0,0) rectangle ++(\textwidth,-3pt);}
-\newpage%\\ [10pt]
-\tikz{\node[fill=black!20,draw=black!20,rounded corners=1pt,right,text width=\textwidth-.6666em] at (0,0) {\vbox to 46pt{%
+\\ [10pt]\tikz{\node[fill=black!20,draw=black!20,rounded corners=1pt,right,text width=\textwidth-.6666em] at (0,0) {\vbox to 46pt{%
\begin{verbatim}\tikz{\foreach \x/\y in {10/0,100/1,500/2,1000/3,2000/4,3000/5,4000/6}{\wlcolor{\x}
\draw[fill=wlcolor] (\y,0) rectangle ++(1,.5)
node[midway,font=\tiny\bfseries,text=black!50] {\x};}}\end{verbatim}\vfil}};}
@@ -310,31 +331,7 @@ And finally \textit{just for fun} a command that draws a rainbow:
\\ [-5pt]\tikz[overlay]{\fill[white,rounded corners=0pt] (-.3333em,0) rectangle (\linewidth+.3333em,-3pt);}%
\\ [3pt]\txtspecopt[element=Ne]}%
{\pgfspectraStyleReset\pgfspectra[element=Ne]}{.05\linewidth-.3333em}
-\newpage%\vspace{-32pt}\
-\subsection*{}{\normalfont\large\bfseries\raisebox{1.25pt}{$\mathbf{\blacktriangleright}$}\ Utilization of \txttempercolor{Kelvin}}%
-\addcontentsline{toc}{subsection}{\texorpdfstring{\txttempercolor{Kelvin}}{\textbackslash tempercolor}}%
-\label{command:tempercolor}%
-\index{COMMANDS@\textbf{COMMANDS}!\textbackslash tempercolor}%
-\\ [4pt]A command that uses the CIE 1964 10-degree color matching function to convert a given temperature, in Kelvin ($\mathsf{1000\,K\leq T\leq40\hspace{.1ex}000\,K}$), to the respective correlated color. For more information on the implemented algorithm, please see:
-\small\begin{itemize}
-\item\href{https://tannerhelland.com/2012/09/18/convert-temperature-rgb-algorithm-code.html}{https://tannerhelland.com/2012/09/18/convert-temperature-rgb-algorithm-code.html}
-\item\href{https://www.zombieprototypes.com/?p=210}{https://www.zombieprototypes.com/?p=210}
-\item\href{https://github.com/neilbartlett/color-temperature}{https://github.com/neilbartlett/color-temperature}
-\end{itemize}\normalsize
-\tikz{\node[fill=black!20,draw=black!20,rounded corners=1pt,right,text width=\textwidth-.6666em] at (0,0) {\vbox to 86pt{%
-\begin{verbatim}\foreach \T in {1000,1700,1850,2400,2550,2700,3000,3200,%
- 3350,5000,5500,6000,6200,6500,6600,6700,9500,15000,%
- 27000,40000}
- {\tempercolor{\T}\tikz{
- \fill[tempercolor,font=\small] (0,0) rectangle (7.5,.5) %
- node[midway] {\color{black}\T\ K};}\\ [-1pt]%
- }%
-\end{verbatim}\vfil}};}%
-\vspace{-5pt}\begin{center}
-\foreach \T in {1000,1700,1850,2400,2550,2700,3000,3200,3350,5000,5500,6000,6200,6500,6600,6700,9500,15000,27000,40000}{%
-\tempercolor{\T}\tikz{\fill[tempercolor,font=\small] (0,0) rectangle (7.5,.5) node[midway] {\color{black}\T\ K};}\\ [-1pt]}%
-\end{center}
-\vspace{-13pt}\tikz{\draw[fill=black!20,draw=black!20,rounded corners=1pt] (0,0) rectangle ++(\textwidth,-3pt);}
+\vspace{-32pt}\ %
\subsection*{}{\normalfont\large\bfseries\raisebox{1.25pt}{$\mathbf{\blacktriangleright}$}\ Utilization of \txtshade{}}%
\addcontentsline{toc}{subsection}{\texorpdfstring{\txtshade{}}{\textbackslash pgfspectrashade}}%
\index{COMMANDS@\textbf{COMMANDS}!\textbackslash pgfspectrashade}%
@@ -356,104 +353,20 @@ And finally \textit{just for fun} a command that draws a rainbow:
\\ [3pt]\pgfspectrashade[v](380,780){myShadeC}\makebox[\linewidth][c]{\tikz{\fill[shading=myShadeC] (0,0) rectangle (10,.5);}}%
\\ [3pt]\pgfspectrashade[v](380,780){myShadeC}\makebox[\linewidth][c]{\tikz{\fill[shading=myShadeA,shading angle=180] (0,0) rectangle (10,.5);}}%
}{.05\linewidth-.3333em}%
-\vspace{12pt}\ %
-\subsection*{}{\normalfont\large\bfseries\raisebox{1.25pt}{$\mathbf{\blacktriangleright}$}\ Utilization of \txtplotshade}%
-\addcontentsline{toc}{subsection}{\texorpdfstring{\txtplotshade{}}{\textbackslash pgfspectraplotshade}}%
-\index{COMMANDS@\textbf{COMMANDS}!\textbackslash pgfspectraplotshade}%
-\label{command:plotshade}%
-\\ [4pt]This command, without any options, builds and makes available a shading in the wavelength range from $\mathsf{380\,nm}$ to $\mathsf{780\,nm}$ to use in \txtPGFPLOTS{} with the provided `\textcolor{red!50!black}{name}'.
-\\ [6pt]\sectioncom{%
-\txtplotshadecom{myPlotShadeA}%
-\\ [-5pt]\tikz[overlay]{\fill[white,rounded corners=0pt] (-.3333em,0) rectangle (\linewidth+.3333em,-3pt);}%
-\\ \texttt{\textbackslash fbox\{}\txtshadetikz{shading=myPlotShadeA}{0,0}{7.5,.75}\texttt{\}}%
-}{%
-\pgfspectraplotshade{myPlotShadeA}%
-\fbox{\tikz{\fill[shading=myPlotShadeA] (0,0) rectangle (7.5,.75);}}\vspace{3pt}%
-}{.05\linewidth-.3333em}%
-\\ [4pt]The optional argument can receive specific options for the shade or \txtspec{} options:
-\\ [6pt]\sectioncom{%
-\txtplotshadecomoption[shade begin=0,shade end=4000,IRcolor=white,UVcolor=white,\\ shade opacity=.2,gamma=.6]{myPlotShadeB}%
-\\ [-5pt]\tikz[overlay]{\fill[white,rounded corners=0pt] (-.3333em,0) rectangle (\linewidth+.3333em,-3pt);}%
-\\ \texttt{\textbackslash fbox\{}\txtshadetikz{shading=myPlotShadeB}{0,0}{7.5,.75}\texttt{\}}%
-}{%
-\pgfspectraplotshade[shade begin=0,shade end=4000,IRcolor=white,UVcolor=white,shade opacity=.2,gamma=.6]{myPlotShadeB}%
-\fbox{\tikz{\fill[shading=myPlotShadeB] (0,0) rectangle (7.5,.75);}}\vspace{3pt}%
-}{.05\linewidth-.3333em}%
-\\ [4pt]The specific options available are \textcolor{red!50!black}{shade end}, \textcolor{red!50!black}{shade opacity} and \textcolor{red!50!black}{shade opacity color}. See section \hyperlink{OPTIONSplotshade}{The options for \txtplotshadename} for detailed information on using these options. When used in \txtPGFPLOTS{} it's possible to do plots like:
-\\ [2pt]\makebox[\linewidth][c]{\hfil\includegraphics[height=4.75cm]{figsmanual/plotshadecom1.pdf}\hfil\includegraphics[height=4.75cm]{figsmanual/plotshadecom2.pdf}\hfil}%
-\\ [2pt]For these plots and other ones see \hyperlink{example:pgfspectraplots}{Using \txtplotshadename{} and \txtplotmapname{} with \txtPGFPLOTS{}}.
-\newpage%
-%\vspace{-32pt}\ %
-\subsection*{}{\normalfont\large\bfseries\raisebox{1.25pt}{$\mathbf{\blacktriangleright}$}\ Utilization of \txtplotmap}%
-\addcontentsline{toc}{subsection}{\texorpdfstring{\txtplotmap{}}{\textbackslash pgfspectraplotmap}}%
-\index{COMMANDS@\textbf{COMMANDS}!\textbackslash pgfspectraplotmap}%
-\label{command:colormap}%
-\\ [4pt]This command builds and makes available a \textcolor{red!50!black}{\bfseries l}ow or \textcolor{red!50!black}{\bfseries h}igh \textit{resolution} color map in the wavelength range from $380\,nm$ to $780\,nm$ to use in \txtPGFPLOTS{} with the provided `\textcolor{red!50!black}{name}':
-\\ [6pt]\setbox0=\vbox{\begin{verbatim}
-\begin{tikzpicture}
-\begin{axis}[colormap name=myColorMap]
-\addplot+[scatter,only marks,domain=0:8,samples=200] {exp(x)};
-\end{axis}
-\end{tikzpicture}
-\begin{tikzpicture}
-\begin{axis}[colormap name=myColorMap]
-\addplot+[scatter,only marks,domain=0:4*pi,samples=200] {sin(deg(x))};
-\end{axis}
-\end{tikzpicture}
-\end{verbatim}}%
-\sectioncom{\txtplotmapcom{myColorMap}{\small\% low resolution (default value for optional parameter)}%
-\\ [-5pt]\tikz[overlay]{\fill[white,rounded corners=0pt] (-.3333em,0) rectangle (\linewidth+.3333em,-3pt);}%
-\\ \usebox0%
-}{%
-\ \\ [-10pt]\makebox[\linewidth][c]{\includegraphics[height=3.75cm]{figsManual/PGFPLOTS5.pdf}\includegraphics[height=3.75cm]{figsManual/PGFPLOTS6.pdf}}}{.05\linewidth-.3333em}%
-\setbox0=\vbox{\begin{verbatim}
-\begin{tikzpicture}
-\begin{axis}[colormap name=myColorMapH]
-\addplot+[scatter,only marks,domain=0:8,samples=200] {exp(x)};
-\end{axis}
-\end{tikzpicture}
-\begin{tikzpicture}
-\begin{axis}[colormap name=myColorMapH]
-\addplot+[scatter,only marks,domain=0:4*pi,samples=200] {sin(deg(x))};
-\end{axis}
-\end{tikzpicture}
-\end{verbatim}}%
-\\ \sectioncom{\txtplotmapcomoption[h]{myColorMapH}{\small\% high resolution (`h' value in optional parameter)}%
-\\ [-5pt]\tikz[overlay]{\fill[white,rounded corners=0pt] (-.3333em,0) rectangle (\linewidth+.3333em,-3pt);}%
-\\ \usebox0%
-}{%
-\ \\ [-10pt]\makebox[\linewidth][c]{\includegraphics[height=3.75cm]{figsManual/PGFPLOTS7.pdf}\includegraphics[height=3.75cm]{figsManual/PGFPLOTS8.pdf}}}{.05\linewidth-.3333em}%
-\\ Actually using high or low resolution produces the same effect on plot. The difference resides on the number of colors available to the `color of colormap' feature. For more information see \hyperlink{example:pgfspectraplots}{Using \txtplotshadename{} and \txtplotmapname{} with \txtPGFPLOTS{}}.
-%\vfill\vfill%\\ [16pt]
-\\ The above commands -- \txtshadename, \txtplotshadename{} and \mbox{\txtplotmapname} -- were inspired in the \textcolor{purple}{TeX - LaTeX Stack Exchange} questions, \href{https://tex.stackexchange.com/q/576755/95441}{Filling optical spectrum curve with color gradient} and \href{https://tex.stackexchange.com/q/348491/95441}{How to create a electromagnetic spectrum using pgfplots package (together with colormaps)}, which were referred by Stefan Pinnow, as examples, in a features request for the \pack{} package.
-%\vfill%
-%\newpage
-\subsection*{}{\normalfont\large\bfseries\raisebox{1.25pt}{$\mathbf{\blacktriangleright}$}\ Utilization of \txtrainbowtitle{}}%
-\addcontentsline{toc}{subsection}{\texorpdfstring{\txtrainbow{}}{\textbackslash pgfspectrarainbow}}%
-\index{COMMANDS@\textbf{COMMANDS}!\textbackslash pgfspectrarainbow}%
-\label{command:rainbow}%
-\\ [4pt]Without options this command draws a rainbow with the specified radius:
-\\ \sectioncom{\txtrainbowcom{2cm}%
-}{%
-\hfil\includegraphics[scale=2]{figsManual/arcoiris1.pdf}%
-}{0pt}%
-\\ [4pt]The rainbow is designed with the following schema resulting in a clipped and shown region:
-\\ [2pt]\makebox[\linewidth][c]{\includegraphics[scale=1.4]{figsManual/arco_iris.pdf}}%
-% THE OPTIONS
-\\ The options available could be specific options for the rainbow or \textit{common} \txttikz{} options:
-% \newminoroption{option}{default}{description}
-\begin{itemize}
-\item the rainbow specific options:% a comma separated list of 'key=value' pairs as listed below.
-\begin{itemize}
-\item rainbow start%default=.6,% -> 60%
-\item rainbow knock out%default=.4,% -> 40%
-\item rainbow fade%default={},% -> applies a scope fading in clipped region
-\item rainbow transparency%default=0
-\item rainbow background%default=blue,%
-\end{itemize}
-\item the \txttikz{} options: any option known by \txttikz{} and/or \txttikz{} libraries.
-\end{itemize}
-For detailed information on using this command see \hyperlink{OPTIONSrainbow}{The options for \txtrainbowname}.
+\vspace{-20pt}\ %
+\def\tmpSection{\bs{usepgfspectralibrary}\lb\red{name(s)}\rb}%
+\subsection*{}{\normalfont\large\bfseries\raisebox{1.25pt}{$\mathbf{\blacktriangleright}$}\ Utilization of \tmpSection{}}%
+\addcontentsline{toc}{subsection}{\texorpdfstring{\tmpSection{}}{\textbackslash usepgfspectralibrary}}%
+\index{COMMANDS@\textbf{COMMANDS}!\textbackslash usepgfspectralibrary}%
+\label{command:library}%
+\\ [4pt]Use this command to load pgf-spectra libraries anywhere in the document. The \red{name(s)} is a single library \red{name} or a comma separated list of library \red{names}.
+\\ As of now, available libraries are \red{data}, \red{pgfplots}, \red{tempercolor} and \red{rainbow}.
+\\ [6pt]\makebox[\textwidth][c]{\tikz{\node[fill=black!20,draw=black!20,rounded corners=1pt,right,text width=\textwidth-.6666em] at (0,0) {%
+\gray{\% Loading data library}%
+\\ \bs{usepgfspectralibrary}\lb\red{data}\rb%
+\\ \gray{\% Loading data and tempercolor libraries}%
+\\ \bs{usepgfspectralibrary}\lb\red{data,tempercolor}\rb%
+};}}%
\newpage
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\section{\texorpdfstring{The options for \txtspec}{The options for \textbackslash pgfspectra}}
@@ -577,11 +490,15 @@ In fact, setting the relative intensity threshold to $1$ is equivalent to the sp
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\vfill%
\label{option_lines}%
-\option{lines}{\{\}}{A comma separated list of wavelengths in the interval $[10;4000]\,nm$.\\
-\hfill\textit{\footnotesize\textcolor{blue}{(Interval updated in v\version)}}}
+\option{lines}{\{\}}{A comma separated list of wavelengths and/or a range of wavelengths -- \red{start to end} -- in the interval $[10;4000]\,nm$\\
+\hfill\textit{\footnotesize\textcolor{blue}{(Interval updated in v\inversion{2.2.0}; Syntax updated in v\inversion{3.0.0})}}}
\com{\txtspecopt[lines=\{400,500,550,700\}]}{\pgfspectra[lines={400,500,550,700}]}
\\ \com{\txtspecopt[lines=\{200,205,400,500,550,700,850,950,980\},begin=100,end=1000]}%
{\pgfspectra[lines={200,205,400,500,550,700,850,950,980},begin=100,end=1000]}
+\\ \com{\txtspecopt[lines=\{380 to 500\}]}%
+{\pgfspectra[lines={380 to 500}]}
+\\ \com{\txtspecopt[lines=\{420 to 500, 550, 600 to 630, 700, 720\}]}%
+{\pgfspectra[lines={420 to 500, 550, 600 to 630,700,720}]}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\vfill%
\label{option_linewidth}%
@@ -589,12 +506,12 @@ In fact, setting the relative intensity threshold to $1$ is equivalent to the sp
\com{\txtspecopt[line width=2pt]}{\pgfspectra[line width=2pt]}
\\ \com{\txtspecopt[line width=2pt,element=He]}{\pgfspectra[line width=2pt,element=He]}
\label{option_begin}%
-\\ \option{begin}{380}{The starting wavelength in nanometres of the spectrum ($10\leq\lambda\leq4000$).\\ \hfill\textit{\footnotesize\textcolor{blue}{(Interval updated in v\version)}}}
+\\ \option{begin}{380}{The starting wavelength in nanometres of the spectrum ($10\leq\lambda\leq4000$).\\ \hfill\textit{\footnotesize\textcolor{blue}{(Interval updated in v\inversion{2.2.0})}}}
\com{\txtspecopt[begin=500]}{\pgfspectra[begin=500]}%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-\newpage\vspace{-32pt}\ %%\vfill%
+\vfill%
\label{option_end}%
-\option{end}{740}{The finishing wavelength in nanometres of the spectrum ($10\leq\lambda\leq4000$).\\ \hfill\textit{\footnotesize\textcolor{blue}{(Interval updated in v\version)}}}
+\option{end}{740}{The finishing wavelength in nanometres of the spectrum ($10\leq\lambda\leq4000$).\\ \hfill\textit{\footnotesize\textcolor{blue}{(Interval updated in v\inversion{2.2.0})}}}
\com{\txtspecopt[end=500]}{\pgfspectra[end=500]}
\\ [3pt]\textbf{Remark:} \textit{it's obviously possible to set `begin' and `end' at the same time and if desired change the order of the wavelengths.}
\\ [3pt]\com{\txtspecopt[begin=500,end=700]}{\pgfspectra[begin=500,end=700]}
@@ -610,13 +527,16 @@ In fact, setting the relative intensity threshold to $1$ is equivalent to the sp
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\vfill%
\label{option_axis}%
-\option{axis}{false}{By default draws a nanometric axis below the spectrum.\\ In v\minorversion\ is now possible to \textit{change the unit} of the axis.}
+\option{axis}{false}{By default draws a nanometric axis below the spectrum.\\ In v\inversion{2.1.0}\ is now possible to \textit{change the unit} of the axis.}
\com{\txtspecopt[axis]}{\pgfspectra[axis]}%
+%\\ [3pt]\com{\txtspecopt[axis,begin=100,end=1500]}{\pgfspectra[axis,begin=100,end=1500]}%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-\newpage%
-\vskip-13.75ex\ %
+%\newpage%
+%\vskip-13.75ex\ %
+\vfill%
\option{axis step}{20}{The increment (in nanometres) to use in the axis scale.}
\com{\txtspecopt[axis,axis step=50]}{\pgfspectra[axis,axis step=50]}%
+\\ [3pt]\com{\txtspecopt[axis,axis step=50,begin=100,end=1500]}{\pgfspectra[axis,axis step=50,begin=100,end=1500]}%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\label{option_axis ticks}%
\vfill%
@@ -635,7 +555,8 @@ In fact, setting the relative intensity threshold to $1$ is equivalent to the sp
\item micrometre ($\mathsf{\mu}$m): \textcolor{red!50!black}{axis unit=micron}
\item angstrom ({\AA}): \textcolor{red!50!black}{axis unit=A}
\end{itemize}}
-\comnewpage{\txtspecopt[element=H,begin=200,end=1000,axis,axis step=50,axis ticks=4,back=visible40]\\ \txtnewline%
+\newpage%
+\com{\txtspecopt[element=H,begin=200,end=1000,axis,axis step=50,axis ticks=4,back=visible40]\\ \txtnewline%
\txtspecopt[element=H,begin=200,end=1000,axis,axis step=50,axis ticks=4,axis unit=micron,back=visible40]\\ \txtnewline%
\txtspecopt[element=H,begin=200,end=1000,axis,axis step=50,axis ticks=4,axis unit=A,back=visible40]\\ \txtnewline%
\txtspecopt[element=Hg,begin=1000,end=200,axis,axis step=50,axis ticks=4,back=visible40]\\ \txtnewline%
@@ -653,8 +574,8 @@ In fact, setting the relative intensity threshold to $1$ is equivalent to the sp
}}%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\label{option_axis unit precision}%
+%\newpage%
\vfill%
-\label{option_axisunitprecision}%
\newminoroption{axis unit precision}{3}{Sets the precision of the displayed wavelenghts in the axis below the spectrum.}
\com{\txtspecopt[element=H,begin=200,end=1000,axis,axis step=50,axis ticks=4,axis unit=micron,back=visible40]\\ \txtnewline%
\txtspecopt[element=H,begin=200,end=1000,axis,axis step=50,axis ticks=4,axis unit=micron,axis unit precision=2,back=visible40]%
@@ -663,6 +584,20 @@ In fact, setting the relative intensity threshold to $1$ is equivalent to the sp
\vskip1pt\hbox{\pgfspectra[element=H,begin=200,end=1000,axis,axis step=50,axis ticks=4,axis unit=micron,axis unit precision=2,back=visible40]}%
}}%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\newpage%\vfill%\vskip-9.75ex\
+\label{option_axis_label}%
+\vskip-9.75ex\ \option{axis label}{false}{Shows or hides (default) the axis label below it. When this key is set to \red{true}, the \red{axis} key is also set to \red{true}.\hfill\textit{\textcolor{blue}{(new in v3.0.0)}}}
+\com{\txtspecopt[axis label=true]}{\pgfspectra[axis label=true]}%
+\vfill%
+\label{option_axis_label_text}%
+\option{axis label text}{\{\}}{If not empty, shows the axis label with the given text below it. In this case, the \red{axis label} key is set to \red{true}.\hfill\textit{\textcolor{blue}{(new in v3.0.0)}}}
+\com{\txtspecopt[axis label text=\{Wavelength in nanometers\}]}{\pgfspectra[axis label text={Wavelength in nanometers}]}%
+\vfill%
+\label{option_axis_label_position}%
+\option{axis label position}{center}{Sets the position of the axis label to \red{left} or \red{center} or \red{right}.\hfill\textit{\textcolor{blue}{(new in v3.0.0)}}}
+\com{\txtspecopt[axis label=true,axis label position=right]}{\pgfspectra[axis label=true,axis label position=right]}%
+\\ [3pt]\com{\txtspecopt[axis label text=\{Wavelength in nanometers\},axis label position=left]}{\pgfspectra[axis label text={Wavelength in nanometers},axis label position=left]}%
+\\ [3pt]\com{\txtspecopt[axis label text=\{\textbackslash hbox to .925\textbackslash linewidth\{\textbackslash{} Wavelength in\\ nanometers\textbackslash hfill\$\textbackslash lambda\textbackslash,(nm)\$\}\},axis label position=left]}{\pgfspectra[axis label text={\hbox to .925\linewidth{\ Wavelength in nanometers\hfill$\lambda\,(nm)$}},axis label position=left]}%
\vfill%
\label{option_axiscolor}%
\option{axis color}{black}{The color of the axis.}
@@ -751,10 +686,314 @@ Writes the value of the redshift (left below the spectrum).}
\com{\txtspecopt[element=He,back=visible40,gamma=.6,axis,axis step=50,axis ticks=4,begin=100,end=1000,redshift=.5,show redshift value]}
{\pgfspectra[element=He,back=visible40,gamma=.6,axis,axis step=50,axis ticks=4,begin=100,end=1000,redshift=.5,show redshift value]}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\newpage\ \vfill%
+\label{libraries}%
+\section{Libraries}
+In this part the \hypertarget{sec:lib}{library} packages are documented. They provide additional commands to extend the capabilities provided by this package out of the box. The libraries are not loaded by default since many users will not need them.
+\\ [10pt]The available libraries are:
+\begin{itemize}
+\item\textbf{data} library:
+\begin{itemize}\item[--]provides the commands to display and/or export to a file the spectral lines of selected elements.\end{itemize}
+\item\textbf{pgfplots} library:
+\begin{itemize}\item[--]provides the commands to create a plot shade or a plot map to use with \mbox{\txtPGFPLOTS}.\end{itemize}
+\item\textbf{tempercolor} library:
+\begin{itemize}\item[--]provides the command to converts a temperature (in Kelvin) into its correlated color.\end{itemize}
+\item\textbf{rainbow} library:
+\begin{itemize}\item[--]provides the command to draw a rainbow.\end{itemize}
+\end{itemize}
+\vfill\vfill%
+\newpage%
+\subsection*{}{\normalfont\large\bfseries\raisebox{1.25pt}{$\mathbf{\blacktriangleright}$}\ data Library}%
+\label{library:data}\addcontentsline{toc}{subsection}{\texorpdfstring{\cyan{\textbf{data}}}{data}}%
+\index{LIBRARIES@\textbf{\cyan{LIBRARIES}}!data@\textbf{\red{data}}}%
+\\ [10pt]\pgfspectralib{data}{%
+This library implements a command that allows the user to extract the spectral lines data used by \txtspec. After that using one of the other two commands provided it is possible do display the data in a table or export it to a file.
+\\ The commands are:
+\begin{itemize}
+\item\bs{pgfspectradata}\lp\red{name of data set}\rp\lb\red{keys}\rb%
+\item\bs{pgfspectratable}\lp\red{table options}\rp\lb\red{name(s) of data set(s)}\rb%
+\item\bs{pgfspectrawrite}\lp\red{filename}\rp\lb\red{name(s) of data set(s)}\rb%
+\end{itemize}
+}%pgfspectralib
+\vspace{-10pt}%
+\def\tmpName{\bs{pgfspectradata}}%
+\def\tmpCom{\bs{pgfspectradata}\lp\red{name of data set}\rp\lb\red{keys}\rb}%
+\subsubsection*{}{\pgfspectralibsubsubsection{Utilization of \tmpCom}}%
+\addcontentsline{toc}{subsubsection}{\texorpdfstring{\tmpCom{}}{\textbackslash pgfspectradata}}%
+\label{command:pgfspectradata}%
+\index{LIBRARIES@\textbf{\cyan{LIBRARIES}}!data@\textbf{\red{data}}!\blue{\textbackslash pgfspectradata}}%
+\\ [10pt]This command loads spectral lines data of the element or elements specified with the \mbox{\red{element}} key. Note that this key is exactly the same as the one used in \txtspec.
+\\ This command also shares the \red{charge}, \red{Imin}, \red{redshift}, \red{begin} and \red{end} keys with \mbox{\txtspec}, but has its own \red{precision} and \red{unit} keys.
+\\ \bs{pgfspectradata} does not produce any \textit{visible} output, but it does the \textit{work} needed by \bs{pgfspectratable} and \bs{pgfspectrawrite} commands. The optional \red{name of data set} argument makes that \textit{name} available for use with \mbox{\bs{pgfspectratable}} or \bs{pgfspectrawrite}.
+\\ [4pt]See \hyperlink{commandpgfspectratable}{utilization of \bs{pgfspectratable}} and \hyperlink{commandpgfspectrawrite}{utilization of \bs{pgfspectrawrite}} for examples of the application of this command.
+\subsubsection*{}{\pgfspectralibsubsubsection{The options for \tmpName}}%
+\addcontentsline{toc}{subsubsection}{\texorpdfstring{The options for \tmpName}{The options for \textbackslash pgfspectradata}}%
+\label{command:pgfspectradata:options}%
+\index{LIBRARIES@\textbf{\cyan{LIBRARIES}}!data@\textbf{\red{data}}!\blue{The options for \textbackslash pgfspectradata}}%
+\def\addtoind{!\textbackslash pgfspectradata@\textbf{\textcolor{myblue}{\textbackslash pgfspectradata}}}%
+\label{option_name_of_data_set}%
+\liboption{name of data set}{\{\}}{A name formed of valid letters.\hfill\pgfspectraMnewinversion{3.0.0}}
+\pgfspectradata[dataH]{element=H}%
+\sectioncom{%
+\bs{pgfspectradata}\lp\red{dataH}\rp\lb\red{element=H}\rb%
+}{%
+This command does not generate any visible output, but internally stores the following data:\\ [-3pt]
+\makebox[\linewidth][c]{\dataH}%
+}{0pt}%
+\label{option_precision}%
+\liboption{precision}{1}{Sets the precision of the data internally stored.\hfill\pgfspectraMnewinversion{3.0.0}}
+\pgfspectradata{element=H,precision=2}%
+\sectioncom{%
+\bs{pgfspectradata}\lb\red{element=H,precision=2}\rb%
+}{%
+This command does not generate any visible output, but internally stores the following data:\\
+\makebox[\linewidth][c]{\manualData}%
+}{0pt}%
+\label{option_unit}%
+\liboption{unit}{\{\}}{If empty, the \red{axis unit} key value of \txtspec{} is used, otherwise the \red{unit} key value is used. This key, like \red{axis unit} key, can have the values \red{nm} for nanometers, \red{micron} for micrometers or \red{A} for angstroms.\hfill\pgfspectraMnewinversion{3.0.0}}
+\pgfspectradata{element=H,unit=A}%
+\sectioncom{%
+\bs{pgfspectradata}\lb\red{element=H,unit=A}\rb%
+}{%
+This command does not generate any visible output, but internally stores the following data:\\
+\makebox[\linewidth][c]{\manualData}%
+}{0pt}%
+\pgfspectraStyle[axis unit=micron,begin=100]%
+\pgfspectradata{element=H}%
+\\ \sectioncom{%
+\bs{pgfspectraStyle}\lp\red{axis unit=micron,begin=100}\rp%
+\\ \bs{pgfspectradata}\lb\red{element=H}\rb%
+}{%
+This command does not generate any visible output, but internally stores the following data:\\
+\makebox[\linewidth][c]{\manualData}%
+}{0pt}%
+\pgfspectraStyleReset%
+\\ \tikz{\node[fill=black!20,draw=black!20,rounded corners=1pt,right,text width=\textwidth-.6666em] at (0,0) {\bs{pgfspectraStyleReset}};}
+\def\tmpName{\bs{pgfspectratable}}%
+\def\tmpCom{\bs{pgfspectratable}\lp\red{table options}\rp\lb\red{name(s) of data set(s)}\rb}%
+\subsubsection*{}{\pgfspectralibsubsubsection{Utilization of \tmpCom}}%
+\addcontentsline{toc}{subsubsection}{\texorpdfstring{\tmpCom{}}{\textbackslash pgfspectratable}}%
+\label{command:pgfspectratable}%
+\index{LIBRARIES@\textbf{\cyan{LIBRARIES}}!data@\textbf{\red{data}}!\blue{\textbackslash pgfspectratable}}%
+\\ [10pt]\hypertarget{commandpgfspectratable}{This command} displays the loaded data in a table. Both arguments are optional.
+\\ [4pt]When used without arguments, the last \textit{unnamed} data loaded is used:
+\\ \sectioncom{%
+\bs{pgfspectradata}\lb\red{element=Ne}\rb\gray{\% loads the spectral lines of neon}%
+\\ \textbackslash\textbackslash\ \bs{pgfspectratable}\gray{\% displays the table...}%
+}{%
+\pgfspectradata{element=Ne}%
+\pgfspectratable%
+}{0pt}%
+\\ [10pt]The \red{table options} keys are \red{title}, \red{back color}, \red{data back color}, \red{text color}, \red{width} and \mbox{\red{elements column width}}.
+\\ [10pt]The optional \red{name(s) of data set(s)} argument is either a single name or a comma separated list of names previously defined via \bs{pgfspectradata}.
+\subsubsection*{}{\pgfspectralibsubsubsection{The options for \tmpName}}%
+\addcontentsline{toc}{subsubsection}{\texorpdfstring{The options for \tmpName}{The options for \textbackslash pgfspectratable}}%
+\label{command:pgfspectratable:options}%
+\index{LIBRARIES@\textbf{\cyan{LIBRARIES}}!data@\textbf{\red{data}}!\blue{The options for \textbackslash pgfspectratable}}%
+\def\addtoind{!\textbackslash pgfspectratable@\textbf{\textcolor{myblue}{\textbackslash pgfspectratable}}}%
+\label{option_title}%
+\liboptionmultiline{title}{<REDSHIFTED >SPECTRAL LINES OF ELEMENT(S)\\ {\small<\textbackslash\textbackslash\ redshift value>}\\ \textbackslash\textbackslash\ wavelength in \red{unit}</relative intensity>}%
+{Sets the title in the table header.\hfill\pgfspectraMnewinversion{3.0.0}}
+\newpage%
+\pgfspectradata{element=H}%
+\sectioncom{%
+\bs{pgfspectradata}\lb\red{element=H}\rb%
+\\ \textbackslash\textbackslash\ \bs{pgfspectratable}%
+}{%
+\pgfspectratable
+}{0pt}%
+\pgfspectradata{element={H,He}}%
+\\ \sectioncom{%
+\bs{pgfspectradata}\lb\red{element=\{H,He\}}\rb%
+\\ \textbackslash\textbackslash\ \bs{pgfspectratable}%
+}{%
+\pgfspectratable
+}{0pt}%
+\pgfspectradata[Hrs]{element=H,redshift={D=0.01/180}}%
+\\ \sectioncom{%
+\bs{pgfspectradata}\lp\red{Hrs}\rp\lb\red{element=H,redshift=\{D=0.01/180\}}\rb%
+\\ \textbackslash\textbackslash\ \bs{pgfspectratable}\lb\red{Hrs}\rb%
+}{%
+\pgfspectratable{Hrs}
+}{0pt}%
+\pgfspectradata{element=H,relative intensity}%
+\\ \sectioncom{%
+\bs{pgfspectradata}\lb\red{element=H,relative intensity}\rb%
+\\ \textbackslash\textbackslash\ \bs{pgfspectratable}%
+}{%
+\pgfspectratable
+}{0pt}%
+\pgfspectradata[dataOI]{element={O}}%
+\pgfspectradata[dataOII]{element={O},charge=1}%
+\pgfspectradata[dataOIII]{element={O},charge=2}%
+\pgfspectradata[dataOIV]{element={O},charge=3}%
+\\ \sectioncom{%
+\gray{\% this example requires the LSE data loaded}%
+\\ \gray{\% use \textbackslash usepackage[LSE]\{pgf-spectra\} in the document preamble}%
+\\ \bs{pgfspectradata}\lp\red{dataOI}\rp\lb\red{element=O}\rb%
+\\ \textbackslash\textbackslash\ \bs{pgfspectradata}\lp\red{dataOII}\rp\lb\red{element=O,charge=1}\rb%
+\\ \textbackslash\textbackslash\ \bs{pgfspectradata}\lp\red{dataOIII}\rp\lb\red{element=O,charge=2}\rb%
+\\ \textbackslash\textbackslash\ \bs{pgfspectradata}\lp\red{dataOIV}\rp\lb\red{element=O,charge=3}\rb%
+\\ \textbackslash\textbackslash\ \bs{pgfspectratable}\lp\red{title=\{Oxygen spectral lines in the visible region%
+\textbackslash\textbackslash\ Wavelength in nanometers\textbackslash\textbackslash\ \$\textbackslash lambda\textbackslash,(nm)\$\}}\rp\lb\red{dataOI}\rb%
+\\ \textbackslash\textbackslash\ \bs{pgfspectratable}\lp\red{title=\{Spectral lines of oxygen and its ions in the visible region%
+\textbackslash\textbackslash\ Wavelength in nanometers\}}\rp\lb\red{dataOI,dataOII,dataOIII,dataOIV}\rb%
+}{%
+\pgfspectratable[title={Oxygen spectral lines in the visible region\\ Wavelength in nanometers\\ $\lambda\,(nm)$}]{dataOI}
+\\ \pgfspectratable[title={Spectral lines of oxygen and its ions in the visible region\\ Wavelength in nanometers}]{dataOI,dataOII,dataOIII,dataOIV}
+}{0pt}%
+\label{option_back_color}%
+\liboption{back color}{black!10}%
+{Sets the background color of the table header, of the \textit{element(s)} column, of the table border lines and of the lines between rows.\hfill\pgfspectraMnewinversion{3.0.0}}
+\sectioncom{%
+\bs{pgfspectratable}\lp\red{back color=blue!10}\rp%
+}{%
+\pgfspectratable[back color=blue!10]
+}{0pt}%
+\label{option_data_back_color}%
+\liboption{data back color}{white}%
+{Sets the background color of each data row.\hfill\pgfspectraMnewinversion{3.0.0}}
+\sectioncom{%
+\bs{pgfspectratable}\lp\red{data back color=black!5}\rp%
+}{%
+\pgfspectratable[data back color=black!5]
+}{0pt}%
+\label{option_text_color}%
+\liboption{text color}{black}{Sets the color of all text in the table.\hfill\pgfspectraMnewinversion{3.0.0}}
+\sectioncom{%
+\bs{pgfspectratable}\lp\red{text color=blue!50!black}\rp%
+}{%
+\pgfspectratable[text color=blue!50!black]
+}{0pt}%
+\label{option_width_(table)}%
+\liboption{width}{\textbackslash linewidth}{Sets the total width of the table.\hfill\pgfspectraMnewinversion{3.0.0}}
+\sectioncom{%
+\lblue{\textbackslash begin}\lb\green{center}\rb
+\bs{pgfspectratable}\lp\red{width=.75\textbackslash linewidth}\rp%
+\lblue{\textbackslash end}\lb\green{center}\rb
+}{%
+\makebox[\linewidth][c]{\pgfspectratable[width=.75\linewidth]}
+}{0pt}%
+\label{option_elements_column_width}%
+\liboption{elements column width}{2.5em}{Sets the width of the \textit{element(s)} column.\hfill\pgfspectraMnewinversion{3.0.0}}
+\sectioncom{%
+\bs{pgfspectratable}\lp\red{elements column width=.1\textbackslash linewidth}\rp%
+}{%
+\pgfspectratable[elements column width=.1\linewidth]
+}{0pt}%
+\def\tmpName{\bs{pgfspectrawrite}}%
+\def\tmpCom{\bs{pgfspectrawrite}\lp\red{filename}\rp\lb\red{name(s) of data set(s)}\rb}%
+\subsubsection*{}{\pgfspectralibsubsubsection{Utilization of \tmpCom}}%
+\addcontentsline{toc}{subsubsection}{\texorpdfstring{\tmpCom{}}{\textbackslash pgfspectrawrite}}%
+\label{command:pgfspectrawrite}%
+\index{LIBRARIES@\textbf{\cyan{LIBRARIES}}!data@\textbf{\red{data}}!\blue{\textbackslash pgfspectrawrite}}%
+\\ [10pt]\hypertarget{commandpgfspectrawrite}{This command} \textbf{writes the provided data set(s)} to a file making the data available for use at any time, and in any context.
+\\ [4pt]Both arguments are optional:
+\begin{itemize}
+\item[--]if no \red{filename} is given, the name \orange{\textsf{spectradata.tex}} is used, otherwise the \textit{filename} is formed by any character recognized by the operating system (this means, for instance, that \textsf{\_} character can be used), followed by an optional extension -- \textsf{tex}, \textsf{csv}, \textsf{txt} or \textsf{dat}. If the extension is not present, the \textsf{tex} extension is appended to the given name.
+\item[--]if no \red{name(s) of data set(s)} is given, the last \textit{unnamed} data loaded will be used.
+\end{itemize}
+For example, using just \bs{pgfspectrawrite} writes, in the current working directory, the file \mbox{\textsf{spectradata.tex}} with the following contents, which were the last \textit{unnamed} data loaded:
+\pgfspectrawrite%
+\\ [3pt]\pgfspectraMloadfile spectradata.tex\relax
+\\ [6pt]\bs{pgfspectrawrite}\lp\red{myfile.csv}\rp\ writes, in the current working directory, the file \mbox{\textsf{myfile.csv}} with the following contents, which were the last \textit{unnamed} data loaded:
+\pgfspectrawrite[myfile.csv]%
+\\ [3pt]\pgfspectraMloadfile myfile.csv\relax
\newpage%
-\section{\texorpdfstring{The options for \txtplotshadename}{The options for \textbackslash pgfspectraplotshade}}
+\bs{pgfspectrawrite}\lp\red{oxygen.dat}\rp\lb\red{dataOI,dataOII,dataOIII,dataOIV}\rb\ writes, in the current working directory, the file \mbox{\textsf{oxygen.dat}} with the following contents:
+\pgfspectrawrite[oxygen.dat]{dataOI,dataOII,dataOIII,dataOIV}%
+\\ [3pt]\pgfspectraMloadfile oxygen.dat\relax
+\\ [6pt]\bs{pgfspectrawrite}\lp\red{Hredshift.txt}\rp\lb\red{Hrs}\rb\ writes, in the current working directory, the file \mbox{\textsf{Hredshift.txt}} with the following contents:
+\pgfspectrawrite[Hredshift.txt]{Hrs}%
+\\ [3pt]\pgfspectraMloadfile[RS]Hredshift.txt\relax
+\newpage%
+\subsection*{}{\normalfont\large\bfseries\raisebox{1.25pt}{$\mathbf{\blacktriangleright}$}\ pgfplots Library}%
+\label{library:pgfplots}\addcontentsline{toc}{subsection}{\texorpdfstring{\cyan{\textbf{pgfplots}}}{pgfplots}}%
+\index{LIBRARIES@\textbf{\cyan{LIBRARIES}}!pgfplots@\textbf{\red{pgfplots}}}%
+\\ [10pt]\pgfspectralib{pgfplots}{%
+This library implements two commands that define the necessary \textit{material} needed to be used with the \txtPGFPLOTS{} package, referring to the colors provided by \txtspec.
+\\ The commands are:
+\begin{itemize}
+\item\bs{pgfspectraplotmap}\lp\red{<l|h>}\rp\lb\red{name}\rb%
+\item\bs{pgfspectraplotshade}\lp\red{options}\rp\lb\red{name}\rb%
+\end{itemize}
+The commands -- \txtshadename, \txtplotshadename{} and \mbox{\txtplotmapname} -- were inspired in the \textcolor{purple}{TeX - LaTeX Stack Exchange} questions, \href{https://tex.stackexchange.com/q/576755/95441}{Filling optical spectrum curve with color gradient} and \href{https://tex.stackexchange.com/q/348491/95441}{How to create a electromagnetic spectrum using pgfplots package (together with colormaps)}, which were referred by Stefan Pinnow, as examples, in a features request for the \pack{} package.
+}%pgfspectralib
+\vspace{-10pt}%
+\subsubsection*{}{\pgfspectralibsubsubsection{Utilization of \txtplotmap}}%
+\addcontentsline{toc}{subsubsection}{\texorpdfstring{\txtplotmap{}}{\textbackslash pgfspectraplotmap}}%
+\label{command:colormap}%
+\index{LIBRARIES@\textbf{\cyan{LIBRARIES}}!pgfplots@\textbf{\red{pgfplots}}!\blue{\textbackslash pgfspectraplotmap}}%
+\\ [10pt]This command builds and makes available a \textcolor{red!50!black}{\bfseries l}ow or \textcolor{red!50!black}{\bfseries h}igh \textit{resolution} color map in the wavelength range from $380\,nm$ to $780\,nm$ to use in \txtPGFPLOTS{} with the provided `\textcolor{red!50!black}{name}':
+\\ [6pt]\setbox0=\vbox{\begin{verbatim}
+\begin{tikzpicture}
+\begin{axis}[colormap name=myColorMap]
+\addplot+[scatter,only marks,domain=0:8,samples=200] {exp(x)};
+\end{axis}
+\end{tikzpicture}
+\begin{tikzpicture}
+\begin{axis}[colormap name=myColorMap]
+\addplot+[scatter,only marks,domain=0:4*pi,samples=200] {sin(deg(x))};
+\end{axis}
+\end{tikzpicture}
+\end{verbatim}}%
+\sectioncom{\txtplotmapcom{myColorMap}{\small\% low resolution (default value for optional parameter)}%
+\\ [-5pt]\tikz[overlay]{\fill[white,rounded corners=0pt] (-.3333em,0) rectangle (\linewidth+.3333em,-3pt);}%
+\\ \usebox0%
+}{%
+\ \\ [-10pt]\makebox[\linewidth][c]{\includegraphics[height=3.75cm]{figsManual/PGFPLOTS5.pdf}\includegraphics[height=3.75cm]{figsManual/PGFPLOTS6.pdf}}}{.05\linewidth-.3333em}%
+\setbox0=\vbox{\begin{verbatim}
+\begin{tikzpicture}
+\begin{axis}[colormap name=myColorMapH]
+\addplot+[scatter,only marks,domain=0:8,samples=200] {exp(x)};
+\end{axis}
+\end{tikzpicture}
+\begin{tikzpicture}
+\begin{axis}[colormap name=myColorMapH]
+\addplot+[scatter,only marks,domain=0:4*pi,samples=200] {sin(deg(x))};
+\end{axis}
+\end{tikzpicture}
+\end{verbatim}}%
+\\ \sectioncom{\txtplotmapcomoption[h]{myColorMapH}{\small\% high resolution (`h' value in optional parameter)}%
+\\ [-5pt]\tikz[overlay]{\fill[white,rounded corners=0pt] (-.3333em,0) rectangle (\linewidth+.3333em,-3pt);}%
+\\ \usebox0%
+}{%
+\ \\ [-10pt]\makebox[\linewidth][c]{\includegraphics[height=3.75cm]{figsManual/PGFPLOTS7.pdf}\includegraphics[height=3.75cm]{figsManual/PGFPLOTS8.pdf}}}{.05\linewidth-.3333em}%
+\\ Actually using high or low resolution produces the same effect on plot. The difference resides on the number of colors available to the `color of colormap' feature. For more information see \hyperlink{example:pgfspectraplots}{Using \txtplotshadename{} and \txtplotmapname{} with \txtPGFPLOTS{}}.
+%\vspace{-32pt}\ %
+\subsubsection*{}{\pgfspectralibsubsubsection{Utilization of \txtplotshade}}%
+\addcontentsline{toc}{subsubsection}{\texorpdfstring{\txtplotshade{}}{\textbackslash pgfspectraplotshade}}%
+\label{command:plotshade}%
+\index{LIBRARIES@\textbf{\cyan{LIBRARIES}}!pgfplots@\textbf{\red{pgfplots}}!\blue{\textbackslash pgfspectraplotshade}}%
+\\ [10pt]This command, without any options, builds and makes available a shading in the wavelength range from $\mathsf{380\,nm}$ to $\mathsf{780\,nm}$ to use in \txtPGFPLOTS{} with the provided `\textcolor{red!50!black}{name}'.
+\\ [6pt]\sectioncom{%
+\txtplotshadecom{myPlotShadeA}%
+\\ [-5pt]\tikz[overlay]{\fill[white,rounded corners=0pt] (-.3333em,0) rectangle (\linewidth+.3333em,-3pt);}%
+\\ \texttt{\textbackslash fbox\{}\txtshadetikz{shading=myPlotShadeA}{0,0}{7.5,.75}\texttt{\}}%
+}{%
+\pgfspectraplotshade{myPlotShadeA}%
+\fbox{\tikz{\fill[shading=myPlotShadeA] (0,0) rectangle (7.5,.75);}}\vspace{3pt}%
+}{.05\linewidth-.3333em}%
+\\ [4pt]The optional argument can receive specific options for the shade or \txtspec{} options:
+\\ [6pt]\sectioncom{%
+\txtplotshadecomoption[shade begin=0,shade end=4000,IRcolor=white,UVcolor=white,\\ shade opacity=.2,gamma=.6]{myPlotShadeB}%
+\\ [-5pt]\tikz[overlay]{\fill[white,rounded corners=0pt] (-.3333em,0) rectangle (\linewidth+.3333em,-3pt);}%
+\\ \texttt{\textbackslash fbox\{}\txtshadetikz{shading=myPlotShadeB}{0,0}{7.5,.75}\texttt{\}}%
+}{%
+\pgfspectraplotshade[shade begin=0,shade end=4000,IRcolor=white,UVcolor=white,shade opacity=.2,gamma=.6]{myPlotShadeB}%
+\fbox{\tikz{\fill[shading=myPlotShadeB] (0,0) rectangle (7.5,.75);}}\vspace{3pt}%
+}{.05\linewidth-.3333em}%
+\\ [4pt]The specific options available are \textcolor{red!50!black}{shade end}, \textcolor{red!50!black}{shade opacity} and \textcolor{red!50!black}{shade opacity color}. See \hyperlink{OPTIONSplotshade}{The options for \txtplotshadename} for detailed information on using these options. When used in \txtPGFPLOTS{} it's possible to do plots like:
+\\ [2pt]\makebox[\linewidth][c]{\hfil\includegraphics[height=4.5cm]{figsmanual/plotshadecom1.pdf}\hfil\includegraphics[height=4.5cm]{figsmanual/plotshadecom2.pdf}\hfil}%
+\\ [2pt]For these plots and other ones see \hyperlink{example:pgfspectraplots}{Using \txtplotshadename{} and \txtplotmapname{} with \txtPGFPLOTS{}}.
+%\newpage%
+%\vfill\vfill%\\ [16pt]
+\subsubsection*{}{\pgfspectralibsubsubsection{The options for \txtplotshadename}}%
+\addcontentsline{toc}{subsubsection}{\texorpdfstring{The options for \txtplotshadename}{The options for \textbackslash pgfspectraplotshade}}%
+\label{command:plotshade:options}%
+\index{LIBRARIES@\textbf{\cyan{LIBRARIES}}!pgfplots@\textbf{\red{pgfplots}}!\blue{The options for \textbackslash pgfspectraplotshade}}%
\def\addtoind{!\textbackslash pgfspectraplotshade@\textbf{\textcolor{myblue}{\textbackslash pgfspectraplotshade}}}%
-\hypertarget{OPTIONSplotshade}{This command} creates a shade to use with the \texttt{\large\textbackslash addplot} command provided by the \txtPGFPLOTS{} package. The shade starts at \textsf{\large\textcolor{red!50!black}{shade begin}} and finishes at \textsf{\large\textcolor{red!50!black}{shade end}}. The shading could be adjusted using the following options:
+\\ [10pt]\hypertarget{OPTIONSplotshade}{The command} \txtplotshadename{} creates a shade to use with the \texttt{\large\textbackslash addplot} command provided by the \txtPGFPLOTS{} package. The shade starts at \textsf{\large\textcolor{red!50!black}{shade begin}} and finishes at \textsf{\large\textcolor{red!50!black}{shade end}}. The shading could be adjusted using the following options:
\\ [8pt]\tikz{\node[text width={\textwidth-6pt},inner xsep=3pt,draw=green!50,fill=green!10,below right,rounded corners=3pt] at (0,0) {%
\\ \makebox[12pt][s]{}\textbullet\ shade begin%default=380,% minimum value 0
\\ \makebox[12pt][s]{}\textbullet\ shade end%default=780,% maximum value 16000
@@ -763,9 +1002,9 @@ Writes the value of the redshift (left below the spectrum).}
\\ \makebox[12pt][s]{}\textbullet\ logarithmic%default=false%
};}%
\label{option_shadebegin}%
-\\ [-4pt]\newminorrevoption{shade begin}{380}{This value determines the start wavelength of the computed shading. It should be set equal to the minimum value of the plotted data. It could be different from the inferior limit of the domain provided to the plot (see the \href{http://mirrors.ctan.org/graphics/pgf/contrib/pgfplots/doc/pgfplots.pdf\#page=55}{\txtPGFPLOTS{} package documentation} for more information). The range of accepted values goes from $\mathsf{0\,nm}$ to (\textcolor{red!50!black}{shade end}-1).}%
+\libnewminorrevoption{shade begin}{380}{This value determines the start wavelength of the computed shading. It should be set equal to the minimum value of the plotted data. It could be different from the inferior limit of the domain provided to the plot (see the \href{http://mirrors.ctan.org/graphics/pgf/contrib/pgfplots/doc/pgfplots.pdf\#page=55}{\txtPGFPLOTS{} package documentation} for more information). The range of accepted values goes from $\mathsf{0\,nm}$ to (\textcolor{red!50!black}{shade end}-1).}%
\label{option_shadeend}%
-\\ [-18pt]\newminoroption{shade end}{780}{This value determines the end wavelength of the computed shading. It should be set equal to the maximum value of the plotted data and could be different from the superior limit of the domain provided to the plot. The range of accepted values goes from (\textcolor{red!50!black}{shade begin}+1) to $\mathsf{16\hspace{.1pt}000\,nm}$.\\ \ }%
+\libnewminoroption{shade end}{780}{This value determines the end wavelength of the computed shading. It should be set equal to the maximum value of the plotted data and could be different from the superior limit of the domain provided to the plot. The range of accepted values goes from (\textcolor{red!50!black}{shade begin}+1) to $\mathsf{16\hspace{.1pt}000\,nm}$.\\ \ }%
\\ \com[3pt]{%
\txtplotshadecom{shadeDefault}
\\ [-5pt]\tikz[overlay]{\fill[white,rounded corners=0pt] (-.3333em,0) rectangle (\linewidth+.3333em,-3pt);}%
@@ -815,9 +1054,9 @@ Writes the value of the redshift (left below the spectrum).}
\fbox{\tikz{\fill[shading=shade300to900] (0,0) rectangle (7.5,.75);}}%
}%
\endoption%
-\vfill%
+%\vfill%
\label{option_shadeopacity}%
-\newminoroption{shade opacity}{1}{The opacity of the computed shade. `0' stands for $\mathsf{0\%}$ and the shading is totaly transparent; `1' stands for $\mathsf{100\%}$ and the shading isn't transparent at all.}%
+\libnewminoroption{shade opacity}{1}{The opacity of the computed shade. `0' stands for $\mathsf{0\%}$ and the shading is totaly transparent; `1' stands for $\mathsf{100\%}$ and the shading isn't transparent at all.}%
\\ \com[3pt]{%
\txtplotshadecom{shadeDefault}
\\ [-5pt]\tikz[overlay]{\fill[white,rounded corners=0pt] (-.3333em,0) rectangle (\linewidth+.3333em,-3pt);}%
@@ -843,9 +1082,9 @@ Writes the value of the redshift (left below the spectrum).}
\fbox{\tikz{\fill[shading=shadeOpacity0] (0,0) rectangle (7.5,.75);}}%
}%
\endoption%
-\vfill%
+%\vfill%
\label{option_shadeopacitycolor}%
-\newminoroption{shade opacity color}{white}{The background color of the computed shading. Only visible when \textcolor{red!50!black}{shade opacity} is lesser then 1.}%
+\libnewminoroption{shade opacity color}{white}{The background color of the computed shading. Only visible when \textcolor{red!50!black}{shade opacity} is lesser then 1.}%
\\ \com[3pt]{%
\txtplotshadecom{shadeDefault}
\\ [-5pt]\tikz[overlay]{\fill[white,rounded corners=0pt] (-.3333em,0) rectangle (\linewidth+.3333em,-3pt);}%
@@ -871,9 +1110,9 @@ Writes the value of the redshift (left below the spectrum).}
\fbox{\tikz{\fill[shading=shadeOpacityBlack50] (0,0) rectangle (7.5,.75);}}%
}%
\endoption%
-\newpage\ \vspace{-32pt}%
+%\newpage\ \vspace{-32pt}%
\label{option_shadelogarithmic}%
-\newminorrevoption{logarithmic}{false}{When set to true the shading is build in a logarithmic scale. The smaller wavelengths are \textit{wided} and the longer ones are \textit{shortened} in the displayed region.}%
+\libnewminorrevoption{logarithmic}{false}{When set to true the shading is build in a logarithmic scale. The smaller wavelengths are \textit{wided} and the longer ones are \textit{shortened} in the displayed region.}%
\\ \com[3pt]{%
\txtplotshadecomoption[logarithmic]{logshadeDefault}%
\\ [-5pt]\tikz[overlay]{\fill[white,rounded corners=0pt] (-.3333em,0) rectangle (\linewidth+.3333em,-3pt);}%
@@ -926,10 +1165,73 @@ Writes the value of the redshift (left below the spectrum).}
\vskip0pt\hfil\fbox{\tikz{\fill[shading=logshade10to10000] (0,0) rectangle (7.5,.75);}}}%
}%
\endoption%
-\newpage
-\section{\texorpdfstring{The options for \txtrainbowname}{The options for \textbackslash pgfspectrarainbow}}
+\newpage%
+\subsection*{}{\normalfont\large\bfseries\raisebox{1.25pt}{$\mathbf{\blacktriangleright}$}\ tempercolor Library}%
+\label{library:tempercolor}\addcontentsline{toc}{subsection}{\texorpdfstring{\cyan{\textbf{tempercolor}}}{tempercolor}}%
+\index{LIBRARIES@\textbf{\cyan{LIBRARIES}}!tempercolor@\textbf{\red{tempercolor}}}%
+\\ [10pt]\pgfspectralib{tempercolor}{This library provides the command \txttempercolor{Kelvin} that uses the CIE 1964 10-degree color matching function to convert a given temperature, in Kelvin ($\mathsf{1000\,K\leq T\leq40\hspace{.1ex}000\,K}$), to the respective correlated color. For more information on the implemented algorithm, please see:
+\small\begin{itemize}
+\item\href{https://tannerhelland.com/2012/09/18/convert-temperature-rgb-algorithm-code.html}{https://tannerhelland.com/2012/09/18/convert-temperature-rgb-algorithm-code.html}
+\item\href{https://www.zombieprototypes.com/?p=210}{https://www.zombieprototypes.com/?p=210}
+\item\href{https://github.com/neilbartlett/color-temperature}{https://github.com/neilbartlett/color-temperature}
+\end{itemize}\normalsize}
+\vspace{-10pt}%
+\subsubsection*{}{\pgfspectralibsubsubsection{Utilization of \txttempercolor{Kelvin}}}%
+\addcontentsline{toc}{subsubsection}{\texorpdfstring{\txttempercolor{Kelvin}}{\textbackslash tempercolor}}%
+\label{command:tempercolor}%
+\index{LIBRARIES@\textbf{\cyan{LIBRARIES}}!tempercolor@\textbf{\red{tempercolor}}!\blue{\textbackslash tempercolor}}%
+\\ [10pt]\tikz{\node[fill=black!20,draw=black!20,rounded corners=1pt,right,text width=\textwidth-.6666em] at (0,0) {\vbox to 86pt{%
+\begin{verbatim}\foreach \T in {1000,1700,1850,2400,2550,2700,3000,3200,%
+ 3350,5000,5500,6000,6200,6500,6600,6700,9500,15000,%
+ 27000,40000}
+ {\tempercolor{\T}\tikz{
+ \fill[tempercolor,font=\small] (0,0) rectangle (7.5,.5) %
+ node[midway] {\color{black}\T\ K};}\\ [-1pt]%
+ }%
+\end{verbatim}\vfil}};}%
+\vspace{-5pt}
+\begin{center}
+\foreach \T in {1000,1700,1850,2400,2550,2700,3000,3200,3350,5000,5500,6000,6200,6500,6600,6700,9500,15000,27000,40000}{%
+\tempercolor{\T}\tikz{\fill[tempercolor,font=\small] (0,0) rectangle (7.5,.5) node[midway] {\color{black}\T\ K};}\\ [-1pt]}%
+\end{center}
+\vspace{-13pt}\tikz{\draw[fill=black!20,draw=black!20,rounded corners=1pt] (0,0) rectangle ++(\textwidth,-3pt);}
+\newpage%
+\subsection*{}{\normalfont\large\bfseries\raisebox{1.25pt}{$\mathbf{\blacktriangleright}$}\ rainbow Library}%
+\label{library:rainbow}\addcontentsline{toc}{subsection}{\texorpdfstring{\cyan{\textbf{rainbow}}}{rainbow}}%
+\index{LIBRARIES@\textbf{\cyan{LIBRARIES}}!rainbow@\textbf{\red{rainbow}}}%
+\\ [10pt]\pgfspectralib{rainbow}{This library provides the command \txtrainbowtitle{} that allows you to draw a rainbow with or without options.}
+\vspace{-10pt}%
+\subsubsection*{}{\pgfspectralibsubsubsection{Utilization of {\txtrainbow{}}}}%
+\addcontentsline{toc}{subsubsection}{\texorpdfstring{\txtrainbow{}}{\textbackslash pgfspectrarainbow}}%
+\label{command:rainbow}%
+\index{LIBRARIES@\textbf{\cyan{LIBRARIES}}!rainbow@\textbf{\red{rainbow}}!\blue{\textbackslash pgfspectrarainbow}}%
+\\ [10pt]Without options this command draws a rainbow with the specified radius:
+\\ \sectioncom{\txtrainbowcom{2cm}%
+}{%
+\hfil\includegraphics[scale=2]{figsManual/arcoiris1.pdf}%
+}{0pt}%
+\\ [4pt]The rainbow is designed with the following schema resulting in a clipped and shown region:
+\\ [2pt]\makebox[\linewidth][c]{\includegraphics[scale=1.4]{figsManual/arco_iris.pdf}}%
+% THE OPTIONS
+\\ The options available could be specific options for the rainbow or \textit{common} \txttikz{} options:
+% \newminoroption{option}{default}{description}
+\begin{itemize}
+\item the rainbow specific options:% a comma separated list of 'key=value' pairs as listed below.
+\begin{itemize}
+\item rainbow start%default=.6,% -> 60%
+\item rainbow knock out%default=.4,% -> 40%
+\item rainbow fade%default={},% -> applies a scope fading in clipped region
+\item rainbow transparency%default=0
+\item rainbow background%default=blue,%
+\end{itemize}
+\item the \txttikz{} options: any option known by \txttikz{} and/or \txttikz{} libraries.
+\end{itemize}
+\subsubsection*{}{\pgfspectralibsubsubsection{The options for \txtrainbowname}%
+\addcontentsline{toc}{subsubsection}{\texorpdfstring{The options for \txtrainbowname}{The options for \textbackslash pgfspectrarainbow}}%
+\label{command:colormap}%
+\index{LIBRARIES@\textbf{\cyan{LIBRARIES}}!rainbow@\textbf{\red{rainbow}}!\blue{The options for \textbackslash pgfspectrarainbow}}%
\def\addtoind{!\textbackslash pgfspectrarainbow@\textbf{\textcolor{myblue}{\textbackslash pgfspectrarainbow}}}%
-\hypertarget{OPTIONSrainbow}{For the} command \txtrainbowname{} there are a set of options that control the rainbow drawn.
+\\ [10pt]\hypertarget{OPTIONSrainbow}{For the} command \txtrainbowname{} there are a set of options that control the rainbow drawn.
\\ [8pt]\tikz{\node[text width={\textwidth-6pt},inner xsep=3pt,draw=green!50,fill=green!10,below right,rounded corners=3pt] at (0,0) {%
\\ The specific rainbow options are:
\\ \makebox[12pt][s]{}\textbullet\ rainbow start%default=.6,% -> 60%
@@ -940,15 +1242,15 @@ Writes the value of the redshift (left below the spectrum).}
\\ Some \txttikz{} keys that affect the rainbow are:
\\ \makebox[12pt][s]{}\textbullet\ `color'\\ \makebox[12pt][s]{}\textbullet\ opacity\\ \makebox[12pt][s]{}\textbullet\ scope fading
};}
-\\ [3pt]The default rainbow drawn is:
-\\ [3pt]\com{%
+\\ [10pt]The default rainbow drawn is:
+\\ [6pt]\com{%
\txtrainbowcom{2cm}
}{%
\pgfspectrarainbow{2cm}
}%
-\vfill%
+%\vfill%
\label{option_rainbowstart}%
-\newminoroption{rainbow start}{.6}{The fraction from which the rainbow colors begin, relative to the center of a circle with radius 1. This value should be in the interval [0,1].}
+\libnewminoroption{rainbow start}{.6}{The fraction from which the rainbow colors begin, relative to the center of a circle with radius 1. This value should be in the interval [0,1].}
\\ \com{%
\txtrainbowcomoptionrainbow(rainbow start=.8){2cm}\textcolor{black!60}{\itshape\% the rainbow colors starts at 1.6cm}
\\ \textbackslash hspace\{1cm\}\textcolor{black!60}{\itshape\%}
@@ -956,9 +1258,9 @@ Writes the value of the redshift (left below the spectrum).}
}{%
\pgfspectrarainbow(rainbow start=.8){2cm}\hspace{1cm}\pgfspectrarainbow(rainbow start=.4){2cm}
}%
-\vfill%
+%\vfill%
\label{option_rainbowknockout}%
-\newminoroption{rainbow knock out}{.4}{The relative distance from the half-circle base to perform the clip. This value should be in the interval [-1,1].}
+\libnewminoroption{rainbow knock out}{.4}{The relative distance from the half-circle base to perform the clip. This value should be in the interval [-1,1].}
\\ \com{%
\txtrainbowcomoptionrainbow(rainbow knock out=0){2cm}\textcolor{black!60}{\itshape\% the full half circle}
}{%
@@ -974,15 +1276,15 @@ Writes the value of the redshift (left below the spectrum).}
}{%
\pgfspectrarainbow(rainbow knock out=.8){2cm}
}%
-\newpage%\\
-\com{%
+%\newpage
+\\ \com{%
\txtrainbowcomoptionrainbow(rainbow knock out=-.4){2cm}\textcolor{black!60}{\itshape\% «extending» the half-circle}
}{%
\pgfspectrarainbow(rainbow knock out=-.4){2cm}
}%
-\\ %\vfill%
+%\\ %\vfill%
\label{option_rainbowfade}%
-\newminoroption{rainbow fade}{\{\}}{Applies a scope fading in the clipped region (requires loading the \txttikz{} fadings library). For more information about the fadings see the \txttikz{} manual.}
+\libnewminoroption{rainbow fade}{\{\}}{Applies a scope fading in the clipped region (requires loading the \txttikz{} fadings library). For more information about the fadings see the \txttikz{} manual.}
\\ %\vfill%\newpage%\\
\com{%
\textcolor{black!60}{\itshape\%\textbackslash usetikzlibrary\{fadings\}}%
@@ -994,14 +1296,14 @@ Writes the value of the redshift (left below the spectrum).}
\pgfspectrarainbow(rainbow fade=south){2cm}\hspace{1cm}\pgfspectrarainbow(rainbow fade=west){2cm}
}%
\label{option_raibowtransparency}%
-\newminoroption{rainbow transparency}{0}{The overall transparency of the rainbow. `0' ($\mathsf{0\%}$) stands for the fill colors in the rainbow without transparency ; `1' ($\mathsf{100\%}$) represents a totally transparent rainbow.}
+\libnewminoroption{rainbow transparency}{0}{The overall transparency of the rainbow. `0' ($\mathsf{0\%}$) stands for the fill colors in the rainbow without transparency ; `1' ($\mathsf{100\%}$) represents a totally transparent rainbow.}
\\ \com{%
\txtrainbowcomoptionrainbow(rainbow transparency=.5){2cm}
}{%
\pgfspectrarainbow(rainbow transparency=.5){2cm}
}%
\label{option_rainbowbackground}%
-\newminoroption{rainbow background}{white}{The background color below the rainbow (only visible with transparency).}
+\libnewminoroption{rainbow background}{white}{The background color below the rainbow (only visible with transparency).}
\\ \com{%
\txtrainbowcomoptionrainbow(rainbow background=blue){2cm}
\\ \textbackslash hspace\{1cm\}\textcolor{black!60}{\itshape\%}
@@ -1025,7 +1327,7 @@ Writes the value of the redshift (left below the spectrum).}
}{%
\pgfspectrarainbow[blue,opacity=.5]{2cm}%
}%
-\\ More examples in \hyperlink{example:rainbow}{Using \txtrainbow}.
+\\ [10pt]More examples in \hyperlink{example:rainbow}{Using \txtrainbowname}.
\newpage%
\section{Examples}\vspace{-22pt}%
\subsection*{}{\normalfont\bfseries\raisebox{1.25pt}{$\mathbf{\blacktriangleright}$}\ Using \textbackslash pgfspectra}
@@ -1060,22 +1362,22 @@ Writes the value of the redshift (left below the spectrum).}
{\pgfspectra[height=.7cm,begin=380,end=740,lines={380,425,450,525,550,600,625,640,705},line width=1.25pt,width=.75\linewidth,label,axis,label before text=(B),axis font=\fontsize{4pt}{6pt}\selectfont]}
\\ [3pt]$\checkmark$ Blue LED
\\ [3pt]\com{\txtspecopt%
-[height=.7cm,end=740,lines=\{450,451,452,453,454,455,456,457,458,%
-\\459,460,461,462,463,464,465,466,467,468,469,470,471,472,473,474,475,476,%
-\\477,478,479,480,481,482,483,484,485,486,487,488,489,490,491,492,493,494,%
-\\495,496,497,498,499,500,501,502,503,504,505,506,507,508,509,510\},%
+[height=.7cm,end=740,lines=\{450 to 510\},%
\\line width=1.25pt,\mbox{width=.75\textbackslash linewidth,label,axis,label before text=(C)},%
\\axis font=\textbackslash fontsize\{4pt\}\{6pt\}\textbackslash selectfont]}%
-{\pgfspectra[height=.7cm,end=740,lines={450,451,452,453,454,455,456,457,458,459,460,461,462,463,464,465,466,467,468,469,470,471,472,473,474,475,476,477,478,479,480,481,482,483,484,485,486,487,488,489,490,491,492,493,494,495,496,497,498,499,500,501,502,503,504,505,506,507,508,509,510},line width=1.25pt,width=.75\linewidth,label,axis,label before text=(C),axis font=\fontsize{4pt}{6pt}\selectfont]}%
-\\ [6pt]$\checkmark$ Sun like spectrum%H,He,C,Na,Mg,Fe
+{\pgfspectra[height=.7cm,end=740,lines={450to510},line width=1.25pt,width=.75\linewidth,label,axis,label before text=(C),axis font=\fontsize{4pt}{6pt}\selectfont]}%
+\vfill%\\ [6pt]
+$\checkmark$ Sun like spectrum%H,He,C,Na,Mg,Fe
\\ [3pt]\com{\txtspecopt%
[element=\{H,Fe,Mg,Na\},absorption,line intensity=40,Imin=.05]}%
{\pgfspectra[element={H,Fe,Mg,Na},absorption,line intensity=40,Imin=.05]}
-\\ [6pt]$\checkmark$ Sirius like spectrum
+\vfill%\\ [6pt]
+$\checkmark$ Sirius like spectrum
\\ [3pt]\com{\txtspecopt%
[element=\{H,He\},absorption,line intensity=40,Imin=.05]}%
{\pgfspectra[element={H,He},absorption,line intensity=40,Imin=.05]}
-\\ [6pt]$\checkmark$ ``Classical'' emission spectra of elements:
+\vfill%\\ [6pt]
+$\checkmark$ ``Classical'' emission spectra of elements:
\\ [3pt]\com{\txtspecopt%
[element=H,back=visible40,gamma=.6,label,axis,Imin=.05]}%
{\pgfspectra[element=H,back=visible40,gamma=.6,label,axis,Imin=.05]}
@@ -1955,41 +2257,65 @@ colorbar horizontal,colormap access=map]
\\ [-1pt]\linhaimpar{\hyperlink{option:axis color}{axis color}}{color of the axis}{color}{black}{any named color or user defined color}%
\\ [-1pt]\linhapar{\hyperlink{option:axis font}{axis font}}{font of the axis labels}{font commands}{\{\textbackslash tiny\}}{\TeX\ font commands}%
\\ [-1pt]\linhaimpar{\hyperlink{option:axis font color}{axis font color}}{color of the axis labels}{color}{white}{any named color or user defined color}%
-\\ [-1pt]\linhapar{\hyperlink{option:axis step}{axis step}}{interval in nanometres between two major axis ticks}{integer}{20}{[0;|end-begin|]\hspace{.1pt}nm}%
-\\ [-1pt]\linhaimpar{\hyperlink{option:axis ticks}{axis ticks}}{number of minor ticks}{integer}{0}{\{0,1,2,3,\ldots\}}%
-\\ [-1pt]\linhapar{\hyperlink{option:axis unit}{axis unit}}{unit of the axis labels}{text}{nm}{nm or micron or A}%
-\\ [-1pt]\linhaimpar{\hyperlink{option:axis unit precision}{axis unit precision}}{number of significant digits (for values in nanometres) shown in axis labels}{integer}{3}{\{0,1,2,3,\ldots\}}%
-\\ [-1pt]\linhapar{\hyperlink{option:back}{back}}{spectrum background color}{color}{black}{any named color or user defined color}%
-\\ [-1pt]\linhaimpar{\hyperlink{option:backIRUV}{backIRUV}}{IR and UV emission lines color in emission spectrum or background color of IR and UV regions in absorption spectrum}{color}{black}{any named color or user defined color}%
-\\ [-1pt]\linhapar{\hyperlink{option:backVIS}{backVIS}}{visible region background color in emission spectrum or emission lines color in absorption spectrum}{color}{black}{any named color or user defined color}%
-\\ [-1pt]\linhaimpar{\hyperlink{option:begin}{begin}}{first wavelength, in nanometres}{integer}{380}{[10;4000]\hspace{.1pt}nm}%
-\\ [-1pt]\linhapar{\hyperlink{option:brightness}{brightness}}{brightness color correction as in the CMYK color model}{decimal}{1}{[0;1]}%
-\\ [-1pt]\linhaimpar{\hyperlink{option:charge}{charge}}{charge of the element(s)}{integer}{0}{LSE Data: \{0,1,2,3,4\} NIST Data: \{0,1\}}%
-\\ [-1pt]\linhapar{\hyperlink{option:element}{element}}{chemical symbol of one element or comma sparated list of chemical symbols elements}{text}{NONE}{H to Es except Fr}%
-\\ [-1pt]\linhaimpar{\hyperlink{option:end}{end}}{last wavelength, in nanometres}{integer}{780}{[10;4000]\hspace{.1pt}nm}%
-\\ [-1pt]\linhapar{\hyperlink{option:gamma}{gamma}}{gamma color correction at the edges of the visible region}{decimal}{0.8}{[0;1]}%
-\\ [-1pt]\linhaimpar{\hyperlink{option:height}{height}}{spectrum height}{length}{1cm}{up to maximum \TeX\ dimension (16384pt)}%
-\\ [-1pt]\linhapar{\hyperlink{option:Imin}{Imin}}{minimum intensity of the lines}{decimal}{0}{[0;1]}%
-\\ [-1pt]\linhaimpar{\hyperlink{option:IRcolor}{IRcolor}}{IR emission lines color in emission spectrum or background color of IR region in absorption spectrum}{color}{rgb(.3157,.2373,\vskip0pt.2373)}{any named color or user defined color}%
-\\ [-1pt]\linhapar{\hyperlink{option:label}{label}}{show or hide the axis labels}{boolean}{false}{\{true, false\}}%
-\\ [-1pt]\linhaimpar{\hyperlink{option:label after text}{label after text}}{extra text to place after the label of the spectrum}{text}{\{\}}{}%
-\\ [-1pt]\linhapar{\hyperlink{option:label before text}{label before text}}{extra text to place before the label of the spectrum}{text}{\{\}}{}%
-\\ [-1pt]\linhaimpar{\hyperlink{option:label font}{label font}}{font of the spectrum label}{font commands}{\{\textbackslash bfseries\textbackslash small\}}{}%
-\\ [-1pt]\linhapar{\hyperlink{option:label font color}{label font color}}{color of the font of the spectrum label}{color}{black}{any named color or user defined color}%
-\\ [-1pt]\linhaimpar{\hyperlink{option:label position}{label position}}{position of the label of the spectrum}{text}{\{west\}}{\{west, north west,\vskip0pt north, north east,\vskip0pt east, south east,\vskip0pt south, south west\}}%
-\\ [-1pt]\linhapar{\hyperlink{option:line intensity}{line intensity}}{draw all lines with the same intensity value}{integer}{100}{\{0,1,2,\dots,99,100\}}%
-\\ [-1pt]\linhaimpar{\hyperlink{option:linewidth}{line width}}{width of each line drawn in the spectrum}{length}{1pt}{up to maximum \TeX\ dimension (16384pt)}%
+\\ [-1pt]\linhapar{\hyperlink{option:axis label}{axis label}}{shows or hides the axis label below it}{boolean}{false}{\{true, false\}}%
+\\ [-1pt]\linhaimpar{\hyperlink{option:axis label position}{axis label position}}{sets the position of the axis label}{text}{center}{left or center or right}%
+\\ [-1pt]\linhapar{\hyperlink{option:axis label text}{axis label text}}{if not empty, shows the axis label with the given text below it}{text}{\{\}}{}%
+\\ [-1pt]\linhaimpar{\hyperlink{option:axis step}{axis step}}{interval in nanometres between two major axis ticks}{integer}{20}{[0;|end-begin|]\hspace{.1pt}nm}%
+\\ [-1pt]\linhapar{\hyperlink{option:axis ticks}{axis ticks}}{number of minor ticks}{integer}{0}{\{0,1,2,3,\ldots\}}%
+\\ [-1pt]\linhaimpar{\hyperlink{option:axis unit}{axis unit}}{unit of the axis labels}{text}{nm}{nm or micron or A}%
+\\ [-1pt]\linhapar{\hyperlink{option:axis unit precision}{axis unit precision}}{number of significant digits (for values in nanometres) shown in axis labels}{integer}{3}{\{0,1,2,3,\ldots\}}%
+\\ [-1pt]\linhaimpar{\hyperlink{option:back}{back}}{spectrum background color}{color}{black}{any named color or user defined color}%
+\\ [-1pt]\linhapar{\hyperlink{option:backIRUV}{backIRUV}}{IR and UV emission lines color in emission spectrum or background color of IR and UV regions in absorption spectrum}{color}{black}{any named color or user defined color}%
+\\ [-1pt]\linhaimpar{\hyperlink{option:backVIS}{backVIS}}{visible region background color in emission spectrum or emission lines color in absorption spectrum}{color}{black}{any named color or user defined color}%
+\\ [-1pt]\linhapar{\hyperlink{option:begin}{begin}}{first wavelength, in nanometres}{integer}{380}{[10;4000]\hspace{.1pt}nm}%
+\\ [-1pt]\linhaimpar{\hyperlink{option:brightness}{brightness}}{brightness color correction as in the CMYK color model}{decimal}{1}{[0;1]}%
+\\ [-1pt]\linhapar{\hyperlink{option:charge}{charge}}{charge of the element(s)}{integer}{0}{LSE Data: \{0,1,2,3,4\} NIST Data: \{0,1\}}%
+\\ [-1pt]\linhaimpar{\hyperlink{option:element}{element}}{chemical symbol of one element or comma sparated list of chemical symbols elements}{text}{NONE}{H to Es except Fr}%
+\\ [-1pt]\linhapar{\hyperlink{option:end}{end}}{last wavelength, in nanometres}{integer}{780}{[10;4000]\hspace{.1pt}nm}%
+\\ [-1pt]\linhaimpar{\hyperlink{option:gamma}{gamma}}{gamma color correction at the edges of the visible region}{decimal}{0.8}{[0;1]}%
+\\ [-1pt]\linhapar{\hyperlink{option:height}{height}}{spectrum height}{length}{1cm}{up to maximum \TeX\ dimension (16384pt)}%
+\\ [-1pt]\linhaimpar{\hyperlink{option:Imin}{Imin}}{minimum intensity of the lines}{decimal}{0}{[0;1]}%
+\\ [-1pt]\linhapar{\hyperlink{option:IRcolor}{IRcolor}}{IR emission lines color in emission spectrum or background color of IR region in absorption spectrum}{color}{rgb(.3157,.2373,\vskip0pt.2373)}{any named color or user defined color}%
+\\ [-1pt]\linhaimpar{\hyperlink{option:label}{label}}{show or hide the axis labels}{boolean}{false}{\{true, false\}}%
+\\ [-1pt]\linhapar{\hyperlink{option:label after text}{label after text}}{extra text to place after the label of the spectrum}{text}{\{\}}{}%
+\\ [-1pt]\linhaimpar{\hyperlink{option:label before text}{label before text}}{extra text to place before the label of the spectrum}{text}{\{\}}{}%
+\\ [-1pt]\linhapar{\hyperlink{option:label font}{label font}}{font of the spectrum label}{font commands}{\{\textbackslash bfseries\textbackslash small\}}{}%
+\\ [-1pt]\linhaimpar{\hyperlink{option:label font color}{label font color}}{color of the font of the spectrum label}{color}{black}{any named color or user defined color}%
+\\ [-1pt]\linhapar{\hyperlink{option:label position}{label position}}{position of the label of the spectrum}{text}{\{west\}}{\{west, north west,\vskip0pt north, north east,\vskip0pt east, south east,\vskip0pt south, south west\}}%
\newpage
\large\txtspec\ (continuation)\normalsize
\\ \header
-\\ [-1pt]\linhapar{\hyperlink{option:lines}{lines}}{number or comma sparated list of numbers}{integer or decimal}{\{\}}{[10;4000]\hspace{.1pt}nm}%
-\\ [-1pt]\linhaimpar{\hyperlink{option:redshift}{redshift}}{computes and draws the redshifted (or blueshifted) lines}{text}{\{\}}{numeric value or \vskip0pt\{numeric value 1/numeric value 2\}}%
-\\ [-1pt]\linhapar{\hyperlink{option:relative intensity}{relative intensity}}{draws the lines using their relative intensities}{boolean}{false}{\{true, false\}}%
-\\ [-1pt]\linhaimpar{\hyperlink{option:relative intensity threshold}{relative intensity\vskip0pt threshold}}{all lines with intensity}{decimal}{0.25}{[0;1]}%
-\\ [-1pt]\linhapar{\hyperlink{option:show redshift value}{show redshift value}}{show or hide the redshift value}{boolean}{false}{\{true, false\}}%
-\\ [-1pt]\linhaimpar{\hyperlink{option:use visible shading}{use visible shading}}{visible region is drawn using a shading (instead of line by line)}{boolean}{true}{\{true, false\}}%
-\\ [-1pt]\linhapar{\hyperlink{option:UVcolor}{UVcolor}}{UV emission lines color in emission spectrum or background color of UV region in absorption spectrum}{color}{rgb(.3,.2568,.3)}{any named color or user defined color}%
-\\ [-1pt]\linhaimpar{\hyperlink{option:width}{width}}{spectrum width}{length}{\{0.9\textbackslash textwidth\}}{up to maximum \TeX\ dimension (16384pt)}%
+\\ [-1pt]\linhaimpar{\hyperlink{option:line intensity}{line intensity}}{draw all lines with the same intensity value}{integer}{100}{\{0,1,2,\dots,99,100\}}%
+\\ [-1pt]\linhapar{\hyperlink{option:linewidth}{line width}}{width of each line drawn in the spectrum}{length}{1pt}{up to maximum \TeX\ dimension (16384pt)}%
+\\ [-1pt]\linhaimpar{\hyperlink{option:lines}{lines}}{number or comma sparated list of numbers}{integer or decimal}{\{\}}{[10;4000]\hspace{.1pt}nm}%
+\\ [-1pt]\linhapar{\hyperlink{option:redshift}{redshift}}{computes and draws the redshifted (or blueshifted) lines}{text}{\{\}}{numeric value or \vskip0pt\{D=numeric value between [0;1]/any angle value in degrees\}}%
+\\ [-1pt]\linhaimpar{\hyperlink{option:relative intensity}{relative intensity}}{draws the lines using their relative intensities}{boolean}{false}{\{true, false\}}%
+\\ [-1pt]\linhapar{\hyperlink{option:relative intensity threshold}{relative intensity\vskip0pt threshold}}{all lines with intensity}{decimal}{0.25}{[0;1]}%
+\\ [-1pt]\linhaimpar{\hyperlink{option:show redshift value}{show redshift value}}{show or hide the redshift value}{boolean}{false}{\{true, false\}}%
+\\ [-1pt]\linhapar{\hyperlink{option:use visible shading}{use visible shading}}{visible region is drawn using a shading (instead of line by line)}{boolean}{true}{\{true, false\}}%
+\\ [-1pt]\linhaimpar{\hyperlink{option:UVcolor}{UVcolor}}{UV emission lines color in emission spectrum or background color of UV region in absorption spectrum}{color}{rgb(.3,.2568,.3)}{any named color or user defined color}%
+\\ [-1pt]\linhapar{\hyperlink{option:width}{width}}{spectrum width}{length}{\{0.9\textbackslash textwidth\}}{up to maximum \TeX\ dimension (16384pt)}%
+% \pgfspectradata
+\\ [10pt]\large\bs{pgfspectradata}\normalsize
+\\ \header\def\myast{ \raisebox{-4pt}{\large$\mathsf{^{^\ast}}$}}
+\\ [-1pt]\linhaimpar{\hyperlink{optionlib:precision}{precision}}{numerical precision of the data internally stored}{integer}{1}{non negative integer}%
+\\ [-1pt]\linhapar{\hyperlink{optionlib:unit}{unit}}{unit of the spectral lines data}{text}{\{\}}{nm or micron or A}%
+\\ [-1pt]\linhaimpar{\hyperlink{optionlib:begin}{begin}}{first wavelength, in nanometres}{integer}{380}{[10;4000]\hspace{.1pt}nm}%
+\\ [-1pt]\linhapar{\hyperlink{optionlib:charge}{charge\myast}}{charge of the element(s)}{integer}{0}{LSE Data: \{0,1,2,3,4\} NIST Data: \{0,1\}}%
+\\ [-1pt]\linhaimpar{\hyperlink{optionlib:element}{element\myast}}{chemical symbol of one element or comma sparated list of chemical symbols elements}{text}{NONE}{H to Es except Fr}%
+\\ [-1pt]\linhapar{\hyperlink{optionlib:end}{end\myast}}{last wavelength, in nanometres}{integer}{780}{[10;4000]\hspace{.1pt}nm}%
+\\ [-1pt]\linhaimpar{\hyperlink{optionlib:Imin}{Imin\myast}}{minimum intensity of the lines}{decimal}{0}{[0;1]}%
+\\ [-1pt]\linhapar{\hyperlink{optionlib:redshift}{redshift\myast}}{numerical precision of the data internally stored}{text}{\{\}}{numeric value or \vskip0pt\{D=numeric value between [0;1]/any angle value in degrees\}}%
+\\ \textit{\red{\myast{}}\footnotesize\ options shared with \txtspec{}}%
+% \pgfspectratable
+\\ [10pt]\large\bs{pgfspectratable}\normalsize
+\\ \header
+\\ [-1pt]\linhaimpar{\hyperlink{optionlib:backcolor}{back color}}{background color of the table header, of the \textit{element(s)} column, of the table border lines and of the lines between rows}{color}{black!10}{any named color or user defined color}%
+\\ [-1pt]\linhapar{\hyperlink{optionlib:databackcolor}{data back color}}{the background color of each data row}{color}{white}{any named color or user defined color}%
+\\ [-1pt]\linhaimpar{\hyperlink{optionlib:elementscolumnwidth}{elements column width}}{the width of the \textit{element(s)} column}{length}{2.5em}{up to maximum \TeX\ dimension (16384pt)}%
+\\ [-1pt]\linhapar{\hyperlink{optionlib:textcolor}{text color}}{the color of all text in the table}{color}{black}{any named color or user defined color}%
+\\ [-1pt]\linhaimpar{\hyperlink{optionlib:title}{title}}{the title in the table header}{text}{<REDSHIFTED>\\ SPECTRAL LINES OF ELEMENT(S) \ldots}{}%
+\\ [-1pt]\linhapar{\hyperlink{optionlib:width}{width}}{the total width of the table}{length}{\textbackslash linewidth}{up to maximum \TeX\ dimension (16384pt)}%
% \pgfspectraplotshade
\\ [10pt]\large\txtplotshadename\normalsize
\\ \header