Debian Codegraph @

texmf-dist/doc/latex/pgf-spectra/README

raw
1 This is pgf-spectra, version 3.0.2 (16/06/2025).
2
3 This package provides the \pgfspectra[<options>] command which draws continuous and emission or absorption spectra for 98 elements and their ions.
4 It was developed mainly for the writing of my own documentation and exams sheets supporting directly PDF output format.
5 The drawing is made with the TikZ package and is based in the pst-spectra extension for PSTricks.
6 It also allows the user to draw a spectrum with their own personal data.
7 The lines data extends from Extreme UV to Near IR (from 10 to 4000 nanometers).
8 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.
9 Spectral lines data can be presented in a table or exported to a file.
10 This package also provides color conversion (correlated color temperature), shadings for use with TikZ and/or PGFPLOTS, color maps for use with PGFPLOTS,
11 displaying the spectral lines in a table and exporting the lines data files.
12 ____________________________________________________________
13
14 ** Requirements: TikZ package.
15 ** Installation: unpack everything in a directory in the TeX search path and refresh the TeX database.
16 ** Usage: just place \usepackage{pgf-spectra} in the preamble.
17 ** Contact the author: Hugo Gomes ([email protected])
18 ** Licence: released under the LaTeX Project Public License v1.3 or later, see http://www.latex-project.org/lppl.txt
19 ____________________________________________________________
20
21 *** v3.0.2 (16/06/2025) ***
22 Fixed incorrect interaction of \pgfspectraplotshade with \pgfkeys{/pgf/number format/.cd,set decimal separator={,}}
23 See
24 https://tex.stackexchange.com/questions/746103/problem-with-pgf-spectra-and-use-comma/746104#746104
25 for more details.
26 -------------------------------------------------------
27
28 *** v3.0.1a (07/07/2024) ***
29 Removed lines data outside the range 10nm - 4000nm (H, He, Be, C, Si, Kr, Sn, I) in LSE data file, which generate a package warning, e.g.
30 «Package pgf-spectra Warning: invalid wavelength (4051.1602nm). The wavelength must be lesser or equal to 4000nm (NIR)... on input line 27».
31 Fixed chemical symbol label width producing incorrect alignment on consecutive lines for the spectrum of some elements, e.g.
32 -------------------------------------------------------
33 \pgfspectraStyle[axis,begin=400,end=700,axis step=20,axis ticks=9,axis color=lightgray, axis font color=black,label,width=.88\textwidth,height=0.7cm]
34 \noindent\pgfspectra[element=Cl]
35
36 \noindent\pgfspectra[element=Rn]
37 -------------------------------------------------------
38
39 *** v3.0.1 (27/04/2023) ***
40 Fixed a small bug dealing with the 'axis label'/'axis label text' background color, which occurred when setting a visible background with the 'back' key, e.g.,
41 \pgfspectra[element=H,axis label text={wavenumber in nanometer},back=visible50]
42
43 *** v3.0.0 (25/04/2023) ***
44
45 In the \pgfspectra command, syntax for the key 'lines' has been updated: it is now possible to specify a continuous range using 'start wavelength to end
46 wavelength', for instance, 'lines={380 to 500}' or 'lines={380 to 500,633}' or 'lines={633,555,380 to 500}'.
47 New keys for \pgfspectra:
48 - axis label
49 - axis label text
50 - axis label position
51 New command:
52 - \usepgfspectralibrary (loads pgf-spectra libraries)
53 New library 'data' to load spectral lines data, display it in a table or export it to a file. This library provides the commands:
54 - \pgfspectradata (loads data)
55 - \pgfspectratable (displays data in a table)
56 - \pgfspectrawrite (writes data to a file)
57 Some commands from previous versions have been moved to new libraries:
58 - \pgfspectraplotshade and \pgfspectraplotmap moved to new library 'pgfplots'
59 - \tempercolor moved to new library 'tempercolor'
60 - \pgfspectrarainbow moved to new library 'rainbow'
61 ____________________________________________________________
62
63 Previous versions
64
65 *** v2.2.0 (21/02/2023) ***
66 LSE data renormalized to lower values within TeX capabilities. This prevents 'Dimension too large' errors and subsequent errors in spectrum drawing when
67 using the 'relative intensity' key.
68 Added maximum intensities in IR, visible an UV ranges for both data sources (NIST and LSE). Now, when using the 'relative intensity' key, the interval of
69 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
70 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
71 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
72 as the maximum intensity of all data.
73 Fixed some typos in the manual.
74
75 *** v2.1.2 (03/07/2021) ***
76 Minor fix: wrong char encoding (pgf-spectra.sty, line:1555)
77
78 *** v2.1.1 (27/06/2021) ***
79 Major changes:
80 Small documentation enhancements.
81 Code rewrote for the command \pgfspectraplotshade.
82 New keys for \pgfspectraplotshade:
83 - shade begin
84 - logarithmic
85
86 *** v2.1.0 (12/05/2021) ***
87 The continuous visible region is now drawn via TikZ shading improving a little bit the speed of the whole process.
88 Minor fix: the width of the emission/absortion lines are now correctly drawn
89 New commands:
90 - \tempercolor (correlated color temperature, Kelvin to rgb color)
91 - \pgfspectrashade (for usage with TikZ package)
92 - \pgfspectraplotshade (for usage with PGFPLOTS package)
93 - \pgfspectraplotmap (for usage with PGFPLOTS package)
94 - \pgfspectrarainbow (draws a rainbow)
95 New keys for \pgfspectra:
96 - use visible shading
97 - backVIS
98 - axis unit
99 - axis unit precision
100 Keys for \pgfspectraplotshade:
101 - shade end
102 - shade opacity
103 - shade opacity color
104 Keys for \pgfspectrarainbow:
105 - rainbow fade
106 - rainbow start
107 - rainbow knock out
108 - rainbow background
109 - rainbow transparency
110
111 *** v2.0.0 (15/03/2021) ***
112 Major changes:
113 - the 'window' of spectra now ranges from 10nm to 4000nm
114 and the lines was updated. (In version 1.0 was 380nm to 740nm)
115 - support for redshifted (blueshifted) lines
116 - possibility of setting a style for the spectra's
117 New commands:
118 - \pgfspectraStyle
119 - \pgfspectraStyleReset
120 New keys:
121 - axis ticks (axis minor ticks)
122 - backIRUV (only for emission spectrum)
123 - IRcolor (for emission lines and for the background in absorption spectrum)
124 - UVcolor (for emission lines and for the background in absorption spectrum)
125 - red shift
126 - show redshift value
127
128 *** First release: version 1.0 (15/04/2016) ***
129 Commands:
130 - \pgfspectra
131 - \wlcolor
132 Keys:
133 - element
134 - width
135 - height
136 - back
137 - charge
138 - Imin
139 - lines
140 - line width
141 - begin
142 - end
143 - axis step
144 - axis color
145 - axis font
146 - axis font color
147 - label position
148 - label before text
149 - label after text
150 - label font
151 - label font color
152 - gamma
153 - brightness
154 - line intensity
155 - relative intensity threshold
156 - absorption
157 - axis
158 - label
159 - relative intensity