summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/pgf-spectra/pgf-spectraManual.tex
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2023-02-21 20:45:24 +0000
committerKarl Berry <karl@freefriends.org>2023-02-21 20:45:24 +0000
commitfb228bd5ebd6a7cb6f56ff8eee26ebc9dd15c8f2 (patch)
tree36f8b3bb1188797c2ffa959396dc9f17478db8b9 /Master/texmf-dist/doc/latex/pgf-spectra/pgf-spectraManual.tex
parent757d7f753a95c21c0bffb7626e63d29395714f26 (diff)
pgf-spectra (21feb23)
git-svn-id: svn://tug.org/texlive/trunk@66011 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.tex142
1 files changed, 67 insertions, 75 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 b463370bb65..4dcf3764750 100644
--- a/Master/texmf-dist/doc/latex/pgf-spectra/pgf-spectraManual.tex
+++ b/Master/texmf-dist/doc/latex/pgf-spectra/pgf-spectraManual.tex
@@ -18,13 +18,15 @@
\addtolength{\topmargin}{-1.25cm}
\setlength{\parindent}{0pt}
\setlength{\oddsidemargin}{0pt}
-\def\version{2.0.0}%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\def\version{2.2.0}%
\def\minorversion{2.1.0}%
\def\minorrevversion{2.1.1}%
\def\minorrev{2.1.2}%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\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\minorrev)},%
+pdftitle = {Manual for pgf-spectra (v\version)},%
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},%
@@ -32,8 +34,7 @@ pdfauthor = {\textcopyright Hugo Gomes},%
pdfproducer = {pdfeTeX-1.\the\pdftexversion\pdftexrevision},
}%End options on pdf
\usepackage[ansinew]{inputenc}
-\renewcommand{\rmdefault}{ecverdana}
-\renewcommand{\normalfont}{}
+\usepackage{verdana}
\usepackage{amsfonts}
\usepackage{amssymb}
\usepackage{amsmath}
@@ -45,53 +46,18 @@ pdfproducer = {pdfeTeX-1.\the\pdftexversion\pdftexrevision},
\fancypagestyle{pgfSpectraManual}{%
\fancyhf{} % clear all header and footer fields
\fancyhead[R]{\nouppercase{\leftmark}}%
-\fancyhead[L]{\color{blue}pgf-spectra \minorrev}%
+\fancyhead[L]{\color{blue}pgf-spectra \version}%
\fancyfoot[R]{\textbf{\thepage\ of \pageref{LastPage}}}%
\fancyfoot[L]{\ }}%
-%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-\usepackage{listings}
-\lstdefinestyle{numbers}
- {numbers=left, stepnumber=1, numberstyle=\tiny\color{black!70}, numbersep=10pt}
-\lstset{%
- keywordstyle=\fontfamily{Roboto-LF}\selectfont\footnotesize\color{blue!50!black},%
- basicstyle=\fontfamily{Roboto-LF}\selectfont\footnotesize,%
- style=numbers,%
- breaklines=true,%
- breakindent=10pt,%
- commentstyle=\fontfamily{Roboto-LF}\selectfont\itshape\footnotesize\color{green!50!black},%
- stringstyle=\fontfamily{Roboto-LF}\selectfont\footnotesize,%
- showstringspaces=false,%
- language=[LaTeX]TeX,%
- defaultdialect=[LaTeX]TeX,%
- deletekeywords={gamma,Gamma},%
- classoffset=0,%
- texcsstyle=*[0]{\fontfamily{Roboto-LF}\selectfont\footnotesize\color{blue!50!black}},
- morekeywords={PackageError,RequirePackage,DeclareOption,ExecuteOptions,ProcessOptions,%
- @Roman,@for,ProvidesPackage,setlength},%
- keywordstyle=\fontfamily{Roboto-LF}\selectfont\footnotesize\color{blue!50!black},%
- classoffset=1,%
- texcsstyle=*[1]{\fontfamily{Roboto-LF}\selectfont\footnotesize\color{orange!50!black}},%
- morekeywords={PreviewEnvironment,definecolor,colorlet,pgfkeys,tikz,%
- foreach,pgfmathparse,pgfmathresult,pgfmathprintnumberto,pgfdeclarehorizontalshading,draw,node,%
- pgfdeclareradialshading,pgfdeclareverticalshading,clip},%
- keywordstyle=\fontfamily{Roboto-LF}\selectfont\footnotesize\color{orange!50!black},%
- classoffset=2,%
- texcsstyle=*[2]{\fontfamily{Roboto-LF}\selectfont\footnotesize\color{red!55!black}},%
- morekeywords={wlcolor,tempercolor,pgfspectra,pgfspectraStyle,pgfspectraStyleReset,pgfspectrashade,%
- pgfspectraplotshade,pgfspectraplotmap,pgfspectrarainbow},%
- keywordstyle=\fontfamily{Roboto-LF}\selectfont\footnotesize\color{red!55!black},%
- classoffset=0%
-}
-%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\input{pgf-spectraManual_defs.tex}%
-%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-\title{Manual for pgf-spectra \minorrev}
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\title{Manual for pgf-spectra \version}
\author{Hugo Gomes\\
\texttt{hugo.parelho@gmail.com}}
-\date{3rd July 2021}
-%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\date{\today}
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\begin{document}%
-\usefont{T1}{verdana}{m}{n}%
\vfill
\begin{titlepage}
\maketitle\thispagestyle{empty}%
@@ -104,11 +70,14 @@ pdfproducer = {pdfeTeX-1.\the\pdftexversion\pdftexrevision},
\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.
-\\ [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).
+\\ [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]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}
};}}
@@ -117,9 +86,10 @@ pdfproducer = {pdfeTeX-1.\the\pdftexversion\pdftexrevision},
\newpage%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\pagestyle{empty}%
+\pdfbookmark[1]{Table of contents}{pdfContents}%
\tableofcontents%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-\newpage\addtocounter{page}{-2}
+\newpage\setcounter{page}{1}%
\pagestyle{pgfSpectraManual}
\ \vfill
\section{Installation and usage}
@@ -132,8 +102,15 @@ 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 \minorrevversion{}}%
-\addcontentsline{toc}{subsection}{\texorpdfstring{In version \minorrevversion{}}{In version 2.1.1}}%
+\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}
+\item LSE data \textit{renormalized} to lower values within \TeX{} capabilities.\\ This prevents \texttt{\large Dimension too large} errors and subsequent errors in spectrum drawing when using the \textcolor{red!50!black}{relative intensity} key.
+\item Added maximum intensities in IR, visible an UV ranges for both data sources (NIST and LSE). Now, when using the \textcolor{red!50!black}{relative intensity} key, the interval of wavelengths is detected and the respective maximum intensity is used. For example, if the spectrum is within the visible range, say between 400 and 700 nanometers, the maximum visible intensity will be used. The same is true for ranges only in IR or UV ranges. But, if the spectrum to be drawn is in more than one region -- for example, from 300 to 1000 or from 400 to 1000 or from 300 to 700 nanometers -- the maximum intensity that will be used is defined as the maximum intensity of all data.
+\item Fixed some typos in the manual.
+\end{itemize}
+\vspace{-32pt}\ \subsection*{}{\normalfont\large\bfseries\raisebox{1.25pt}{$\mathbf{\blacktriangleright}$}\ In version 2.1.1}%
+\addcontentsline{toc}{subsection}{In version 2.1.1}%
\begin{itemize}
\item Code rewrote for the command \txtplotshadename, supporting two new keys:
\begin{itemize}
@@ -142,8 +119,8 @@ pdfproducer = {pdfeTeX-1.\the\pdftexversion\pdftexrevision},
\end{itemize}
\end{itemize}
\vspace{-32pt}\
-\subsection*{}{\normalfont\large\bfseries\raisebox{1.25pt}{$\mathbf{\blacktriangleright}$}\ In version \minorversion{}}%
-\addcontentsline{toc}{subsection}{\texorpdfstring{In version \minorversion{}}{In version 2.1.0}}%
+\subsection*{}{\normalfont\large\bfseries\raisebox{1.25pt}{$\mathbf{\blacktriangleright}$}\ In version 2.1.0}%
+\addcontentsline{toc}{subsection}{In version 2.1.0}%
\begin{itemize}
\item The continuous visible region is now drawn via \txttikz{} shading, improving a little bit the speed of the whole process.
\item Minor fix: the width of the emission/absortion lines are now correctly drawn.
@@ -190,9 +167,9 @@ with the following specific keys% \pgfspectraplotshade[options]{name}
% h -> high resolution (401 colors -> 380 to 780 nm ; step 1 nm)
\end{itemize}
\end{itemize}
-\newpage%
-\subsection*{}{\normalfont\large\bfseries\raisebox{1.25pt}{$\mathbf{\blacktriangleright}$}\ In version \version{}}%
-\addcontentsline{toc}{subsection}{\texorpdfstring{In version \version{}}{In version 2.0.0}}%
+\vspace{-32pt}\
+\subsection*{}{\normalfont\large\bfseries\raisebox{1.25pt}{$\mathbf{\blacktriangleright}$}\ In version 2.0.0}%
+\addcontentsline{toc}{subsection}{In version 2.0.0}%
\begin{itemize}
\item The package can now be loaded with one of the following options:
\begin{itemize}
@@ -226,7 +203,7 @@ with the following specific keys% \pgfspectraplotshade[options]{name}
\begin{itemize}
\item had as a result in the previous version (version 1.0):
\\ [3pt]\includegraphics{figsManual/pgfspectraV10badBox.pdf}
- \item and will result in current version (\version) at:
+ \item and will result in version 2.0.0 at:
\\ [3pt]\includegraphics{figsManual/pgfspectraV200goodBox.pdf}
\end{itemize}
\end{itemize}
@@ -273,6 +250,7 @@ And finally \textit{just for fun} a command that draws a rainbow:
\vspace{-32pt}\
\subsection*{}{\normalfont\large\bfseries\raisebox{1.25pt}{$\mathbf{\blacktriangleright}$}\ Utilization of \txtspec{}}%
\label{command:pgfspectra}\addcontentsline{toc}{subsection}{\texorpdfstring{\txtspec{}}{\textbackslash pgfspectra}}%
+\index{COMMANDS@\textbf{COMMANDS}!\textbackslash pgfspectra}%
\\ [4pt]This command is used without options to draw the visible continuous spectrum:
\\ \sectioncom{\txtspec}{\pgfspectra}{.05\linewidth-.3333em}
\\ When using options, a continuous or discrete spectra in the visible region can be drawn, for ins\-tance:
@@ -283,6 +261,7 @@ And finally \textit{just for fun} a command that draws a rainbow:
\\ [-32pt]\ %
\subsection*{}{\normalfont\large\bfseries\raisebox{1.25pt}{$\mathbf{\blacktriangleright}$}\ Utilization of \textcolor{blue!50!black}{\textbackslash wlcolor\{}\textcolor{red!50!black}{wavelength}\textcolor{blue!50!black}{\}}}%
\label{command:wlcolor}\addcontentsline{toc}{subsection}{\texorpdfstring{\textcolor{blue!50!black}{\textbackslash wlcolor\{}\textcolor{red!50!black}{wavelength}\textcolor{blue!50!black}{\}}}{\textbackslash wlcolor}}%
+\index{COMMANDS@\textbf{COMMANDS}!\textbackslash wlcolor}%
\\ [4pt]A command to convert a wavelength from 380 to 780 nanometres (or other value in the range $10\,nm\leq\lambda\leq4000\,nm$) to the respective color available as `wlcolor':
\\ [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 in {380,400,...,780}{\wlcolor{\x}
@@ -309,6 +288,7 @@ And finally \textit{just for fun} a command that draws a rainbow:
\vfill%\\ [-32pt]\
\subsection*{}{\normalfont\large\bfseries\raisebox{1.25pt}{$\mathbf{\blacktriangleright}$}\ Utilization of \txtspecstyle[options]}%
\label{command:pgfspectraStyle}\addcontentsline{toc}{subsection}{\texorpdfstring{\txtspecstyle[options]}{\textbackslash pgfspectraStyle}}%
+\index{COMMANDS@\textbf{COMMANDS}!\textbackslash pgfspectraStyle}%
\\ [4pt]Use this command to set the global style of all the subsequent drawn spectra:
\\ \sectioncom{\txtspecopt[element=Ne]\hfill\color{white}(before defining the global style)}%
{\pgfspectra[element=Ne]}{.05\linewidth-.3333em}%
@@ -324,6 +304,7 @@ And finally \textit{just for fun} a command that draws a rainbow:
\vfill%
\subsection*{}{\normalfont\large\bfseries\raisebox{1.25pt}{$\mathbf{\blacktriangleright}$}\ Utilization of \txtspecstylereset{}}%
\label{command:pgfspectraStyleReset}\addcontentsline{toc}{subsection}{\texorpdfstring{\txtspecstylereset}{\textbackslash pgfspectraStyleReset}}%
+\index{COMMANDS@\textbf{COMMANDS}!\textbackslash pgfspectraStyleReset}%
\\ [4pt]Used to reset all the options of the spectra to their default values:
\\ \sectioncom{\txtspecstylereset%
\\ [-5pt]\tikz[overlay]{\fill[white,rounded corners=0pt] (-.3333em,0) rectangle (\linewidth+.3333em,-3pt);}%
@@ -333,6 +314,7 @@ And finally \textit{just for fun} a command that draws a rainbow:
\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}
@@ -355,6 +337,7 @@ And finally \textit{just for fun} a command that draws a rainbow:
\vspace{-13pt}\tikz{\draw[fill=black!20,draw=black!20,rounded corners=1pt] (0,0) rectangle ++(\textwidth,-3pt);}
\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}%
\label{command:shade}%
\\ [4pt]This commands builds and makes available a \textcolor{red!50!black}{\bfseries h}orizontal or a \textcolor{red!50!black}{\bfseries v}ertical shading, between the `\textcolor{red!50!black}{start}' and `\textcolor{red!50!black}{end}' wavelengths (in nanometres), to use in \txttikz{} pictures with the provided `\textcolor{red!50!black}{name}'.
\\ [2pt]\textit{Note that, in this command, the `start' wavelength needs to be smaller then the `end' wavelength} and is in the visible region: $\lambda_{\textsf{start}}<\lambda_{\textsf{end}}$ and $380\leq\lambda\leq780$.
@@ -376,6 +359,7 @@ And finally \textit{just for fun} a command that draws a rainbow:
\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{%
@@ -402,6 +386,7 @@ And finally \textit{just for fun} a command that draws a rainbow:
%\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}
@@ -445,6 +430,7 @@ And finally \textit{just for fun} a command that draws a rainbow:
%\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}%
@@ -471,6 +457,8 @@ For detailed information on using this command see \hyperlink{OPTIONSrainbow}{Th
\newpage
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\section{\texorpdfstring{The options for \txtspec}{The options for \textbackslash pgfspectra}}
+\colorlet{myblue}{blue!50!black}%
+\def\addtoind{!\textbackslash pgfspectra@\textbf{\textcolor{myblue}{\textbackslash pgfspectra}}}%
\hypertarget{OPTIONS}{For the commands} \txtspec{} and \txtspecsty{} there are a set of options available to draw the spectrum as described below.
\\ [6pt]\tikz{\node[text width=\linewidth-6mm,draw=green!70,rounded corners=2pt,fill=black!10!green!10,inner sep=3mm,text centered] {\color{green!40!black}The list of options is of the form `\textcolor{red!50!black}{key}' or `\textcolor{red!50!black}{key=value}' separated by commas.};}
\vfill%
@@ -497,7 +485,7 @@ For detailed information on using this command see \hyperlink{OPTIONSrainbow}{Th
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\newpage\vspace{-32pt}\ %
\label{option_charge}%
-\option{charge}{0}{The charge of the \textit{particle} to draw the spectrum. Use `all' to get all available lines for the element, i.e, for the atom and all the positive ions that exist in the database.}
+\option{charge}{0}{The charge of the \textit{particle} to draw the spectrum. Use `all' to get all available lines for the element, i.e, for the atom and all the positive ions that exist in the database. For LSE data: a value between 0 and 4; all other values are processed as `all'. For NIST data: 0 or 1. All other values are processed as `all'.}
\com{\txtspecopt[element=He]}{\pgfspectra[element=He]}
\com{\txtspecopt[element=He,charge=1]}{\pgfspectra[element=He,charge=1]}
\com{\txtspecopt[element=He,charge=2]}{\pgfspectra[element=He,charge=2]}
@@ -741,7 +729,7 @@ The redshift value ($z$) is \textit{defined} as $1+z=\lambda_{obs}/\lambda_{E}$
$$1+z=\frac{1+\overline{v}\cos\theta}{\sqrt{1-\overline{v}^2}}\quad\quad\overline{v}=\frac{v}{c}$$
\\ where $\overline{v}$ is the \textit{normalized velocity} (in units of the speed of light in vacuum, $c$) of the emitter and $\theta$ is the angle between the direction of relative motion and the direction of emission in the observer's frame (zero angle is directly away from the observer).
\\ So, if the source of light is moving away from an observer, then redshift occurs ($z>0$), but, if the source moves towards the observer, then blueshift occurs ($z<0$).
-\ \\ [3pt]\makebox[\linewidth][c]{\includegraphics[width=.8\linewidth]{redshift.pdf}}
+\ \\ [3pt]\makebox[\linewidth][c]{\includegraphics[width=.8\linewidth]{figsManual/redshift.pdf}}
\end{itemize}}%
% redshift
\\ [3pt]\com{\txtspecopt[element=He,back=visible40,gamma=.6,axis,axis step=50,axis ticks=4,begin=100,end=1000,redshift=\{D=.001/0\}]}
@@ -765,6 +753,7 @@ Writes the value of the redshift (left below the spectrum).}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\newpage%
\section{\texorpdfstring{The options for \txtplotshadename}{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:
\\ [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
@@ -788,7 +777,7 @@ Writes the value of the redshift (left below the spectrum).}
\\ \com[3pt]{%
\txtplotshadecomoption[shade begin=600]{shadeBegin600}
\\ [-5pt]\tikz[overlay]{\fill[white,rounded corners=0pt] (-.3333em,0) rectangle (\linewidth+.3333em,-3pt);}%
-\\ \texttt{\textbackslash fbox\{}\txtshadetikz{shading=shadeEnd600}{0,0}{7.5,.75}\texttt{\}}%
+\\ \texttt{\textbackslash fbox\{}\txtshadetikz{shading=shadeBegin600}{0,0}{7.5,.75}\texttt{\}}%
}{%
\pgfspectraplotshade[shade begin=600]{shadeBegin600}%
\fbox{\tikz{\fill[shading=shadeBegin600] (0,0) rectangle (7.5,.75);}}%
@@ -796,13 +785,13 @@ Writes the value of the redshift (left below the spectrum).}
\\ \com[3pt]{%
\txtplotshadecomoption[shade end=600]{shadeEnd600}
\\ [-5pt]\tikz[overlay]{\fill[white,rounded corners=0pt] (-.3333em,0) rectangle (\linewidth+.3333em,-3pt);}%
-\\ \texttt{\textbackslash fbox\{}\txtshadetikz{shading=shadeEnd1500}{0,0}{7.5,.75}\texttt{\}}%
+\\ \texttt{\textbackslash fbox\{}\txtshadetikz{shading=shadeEnd600}{0,0}{7.5,.75}\texttt{\}}%
}{%
\pgfspectraplotshade[shade end=600]{shadeEnd600}%
\fbox{\tikz{\fill[shading=shadeEnd600] (0,0) rectangle (7.5,.75);}}%
}%
\\ \com[3pt]{%
-\txtplotshadecomoption[begin=300,shade end=600]{shade300to600}%
+\txtplotshadecomoption[shade begin=300,shade end=600]{shade300to600}%
\\ [-5pt]\tikz[overlay]{\fill[white,rounded corners=0pt] (-.3333em,0) rectangle (\linewidth+.3333em,-3pt);}%
\\ \texttt{\textbackslash fbox\{}\txtshadetikz{shading=shade300to600}{0,0}{7.5,.75}\texttt{\}}%
}{%
@@ -810,7 +799,7 @@ Writes the value of the redshift (left below the spectrum).}
\fbox{\tikz{\fill[shading=shade300to600] (0,0) rectangle (7.5,.75);}}%
}%
\\ \com[3pt]{%
-\txtplotshadecomoption[begin=600,shade end=900]{shade600to900}%
+\txtplotshadecomoption[shade begin=600,shade end=900]{shade600to900}%
\\ [-5pt]\tikz[overlay]{\fill[white,rounded corners=0pt] (-.3333em,0) rectangle (\linewidth+.3333em,-3pt);}%
\\ \texttt{\textbackslash fbox\{}\txtshadetikz{shading=shade600to900}{0,0}{7.5,.75}\texttt{\}}%
}{%
@@ -818,7 +807,7 @@ Writes the value of the redshift (left below the spectrum).}
\fbox{\tikz{\fill[shading=shade600to900] (0,0) rectangle (7.5,.75);}}%
}%
\\ \com[3pt]{%
-\txtplotshadecomoption[begin=300,shade end=900]{shade300to900}%
+\txtplotshadecomoption[shade begin=300,shade end=900]{shade300to900}%
\\ [-5pt]\tikz[overlay]{\fill[white,rounded corners=0pt] (-.3333em,0) rectangle (\linewidth+.3333em,-3pt);}%
\\ \texttt{\textbackslash fbox\{}\txtshadetikz{shading=shade300to900}{0,0}{7.5,.75}\texttt{\}}%
}{%
@@ -882,7 +871,7 @@ Writes the value of the redshift (left below the spectrum).}
\fbox{\tikz{\fill[shading=shadeOpacityBlack50] (0,0) rectangle (7.5,.75);}}%
}%
\endoption%
-\vfill
+\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.}%
\\ \com[3pt]{%
@@ -896,7 +885,7 @@ Writes the value of the redshift (left below the spectrum).}
\vskip0pt\hfil\fbox{\tikz{\fill[shading=logshadeDefault] (0,0) rectangle (7.5,.75);}}}%
}%
\\ \com[3pt]{%
-\txtplotshadecomoption[logarithmic,begin=300,shade end=600]{logshade300to600}%
+\txtplotshadecomoption[logarithmic,shade begin=300,shade end=600]{logshade300to600}%
\\ [-5pt]\tikz[overlay]{\fill[white,rounded corners=0pt] (-.3333em,0) rectangle (\linewidth+.3333em,-3pt);}%
\\ \texttt{\textbackslash fbox\{}\txtshadetikz{shading=shade300to600}{0,0}{7.5,.75}\texttt{\}}%
\\ \txtnewline\texttt{\textbackslash fbox\{}\txtshadetikz{shading=logshade300to600}{0,0}{7.5,.75}\texttt{\}}%
@@ -906,7 +895,7 @@ Writes the value of the redshift (left below the spectrum).}
\vskip0pt\hfil\fbox{\tikz{\fill[shading=logshade300to600] (0,0) rectangle (7.5,.75);}}}%
}%
\\ \com[3pt]{%
-\txtplotshadecomoption[logarithmic,begin=600,shade end=900]{logshade600to900}%
+\txtplotshadecomoption[logarithmic,shade begin=600,shade end=900]{logshade600to900}%
\\ [-5pt]\tikz[overlay]{\fill[white,rounded corners=0pt] (-.3333em,0) rectangle (\linewidth+.3333em,-3pt);}%
\\ \texttt{\textbackslash fbox\{}\txtshadetikz{shading=shade600to900}{0,0}{7.5,.75}\texttt{\}}%
\\ \txtnewline\texttt{\textbackslash fbox\{}\txtshadetikz{shading=logshade600to900}{0,0}{7.5,.75}\texttt{\}}%
@@ -916,7 +905,7 @@ Writes the value of the redshift (left below the spectrum).}
\vskip0pt\hfil\fbox{\tikz{\fill[shading=logshade600to900] (0,0) rectangle (7.5,.75);}}}%
}%
\\ \com[3pt]{%
-\txtplotshadecomoption[logarithmic,begin=300,shade end=900]{logshade300to900}%
+\txtplotshadecomoption[logarithmic,shade begin=300,shade end=900]{logshade300to900}%
\\ [-5pt]\tikz[overlay]{\fill[white,rounded corners=0pt] (-.3333em,0) rectangle (\linewidth+.3333em,-3pt);}%
\\ \texttt{\textbackslash fbox\{}\txtshadetikz{shading=shade300to900}{0,0}{7.5,.75}\texttt{\}}%
\\ \txtnewline\texttt{\textbackslash fbox\{}\txtshadetikz{shading=logshade300to900}{0,0}{7.5,.75}\texttt{\}}%
@@ -926,7 +915,7 @@ Writes the value of the redshift (left below the spectrum).}
\vskip0pt\hfil\fbox{\tikz{\fill[shading=logshade300to900] (0,0) rectangle (7.5,.75);}}}%
}%
\\ \com[3pt]{%
-\txtplotshadecomoption[logarithmic,begin=10,shade end=10000]{logshade10to10000}%
+\txtplotshadecomoption[logarithmic,shade begin=10,shade end=10000]{logshade10to10000}%
\\ [-5pt]\tikz[overlay]{\fill[white,rounded corners=0pt] (-.3333em,0) rectangle (\linewidth+.3333em,-3pt);}%
\\ \texttt{\textbackslash fbox\{}\txtshadetikz{shading=shade10to10000}{0,0}{7.5,.75}\texttt{\}}%
\\ \txtnewline\texttt{\textbackslash fbox\{}\txtshadetikz{shading=logshade300to900}{0,0}{7.5,.75}\texttt{\}}%
@@ -939,6 +928,7 @@ Writes the value of the redshift (left below the spectrum).}
\endoption%
\newpage
\section{\texorpdfstring{The options for \txtrainbowname}{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.
\\ [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:
@@ -2036,8 +2026,10 @@ The code could be a bit slow, so if there are many spectra to draw, the time con
\\ [2pt]\textsf{If tex capacity exceeded when running...
\\ «! TeX capacity exceeded, sorry [main memory size=2000001].»}
\\ [2pt]just make a \textsf{\textbackslash newpage} at the point of origin of the message (ejecting the page releases the \TeX\ memory!)
-\\ [18pt]\ %
-%\newpage%
-\section{The code}
-\lstinputlisting{pgf-spectra.sty}
+\newpage\small%
+\printindex%
\end{document}
+
+%\\ [18pt]\ %
+%\section{The code}
+%\lstinputlisting{pgf-spectra.sty} \ No newline at end of file