| 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 |