CODE V Coatings window and no-design handling

docs-site/astro.config.mjs

@@ -155,6 +155,7 @@ export default defineConfig({
             { label: 'n,k Characterization', translations: { 'zh-CN': 'n,k 表征' }, slug: 'data-exchange/nk-characterization' },
             { label: 'Spectrum File Formats', translations: { 'zh-CN': '光谱文件格式' }, slug: 'data-exchange/spectrum-file-formats' },
             { label: 'Zemax Coatings',   translations: { 'zh-CN': 'Zemax 膜层' }, slug: 'data-exchange/zemax-coatings' },
+            { label: 'CODE V Coatings',  translations: { 'zh-CN': 'CODE V 膜层' }, slug: 'data-exchange/codev-coatings' },
             { label: 'Design Import',    translations: { 'zh-CN': '设计导入' },   slug: 'data-exchange/design-import' },
             { label: 'Process Exporter', translations: { 'zh-CN': '工艺导出' },   slug: 'simulation/process-simulator' },
           ],

docs-site/public/llms.txt

@@ -67,6 +67,7 @@ Design Editor from the substrate outwards.
 
 - [Report](https://docs.tfstudio.xyz/data-exchange/report-generator/): a document assembled from blocks over one or several designs, saved as PDF or HTML.
 - [Zemax Coatings](https://docs.tfstudio.xyz/data-exchange/zemax-coatings/): reading and writing Zemax COATING.DAT files.
+- [CODE V Coatings](https://docs.tfstudio.xyz/data-exchange/codev-coatings/): reading CODE V MUL coatings from .seq and .mul files, and writing a design as a .seq file.
 - [Measured Spectra](https://docs.tfstudio.xyz/data-exchange/measured-spectra/): importing spectrophotometer data for comparison against a design.
 - [Process Exporter](https://docs.tfstudio.xyz/simulation/process-simulator/): exporting a layer schedule for a deposition controller.
 

docs-site/src/components/ribbon-icons.js

@@ -216,15 +216,22 @@ export const ICONS = {
                        Cf(15,6.2,0.9),
                      ]),
 
-  // Zemax Coatings — a data file (coating-layer lines) + bidirectional exchange arrow.
+  // Zemax Coatings: a file holding a table, as COATING.DAT is tables of
+  // materials and coatings.
   'zemax-coatings': I([
-                       R(2.5, 3, 8, 14, 1.2),
-                       L(4.5, 6.5, 8.5, 6.5, 1),
-                       L(4.5, 9, 8.5, 9, 1),
-                       L(4.5, 11.5, 8.5, 11.5, 1),
-                       L(11.5, 10, 17.5, 10, 1.4),
-                       P('M15 7.5 L17.8 10 L15 12.5', 1.4),
-                       P('M14 5 L11.5 7 L14 9', 1.2),
+                       P('M4.5 2.5H11.5L15.5 6.5V17.5H4.5Z'),
+                       P('M11.5 2.5V6.5H15.5', 1.2),
+                       P('M6.5 9H13.5V15.5H6.5Z', 1),
+                       P('M6.5 11.2H13.5M6.5 13.3H13.5M10 9V15.5', 0.9),
+                     ]),
+
+  // CODE V Coatings: a file holding a command prompt, as a .seq is a CODE V
+  // command file.
+  'codev-coatings': I([
+                       P('M4.5 2.5H11.5L15.5 6.5V17.5H4.5Z'),
+                       P('M11.5 2.5V6.5H15.5', 1.2),
+                       P('M7 9.3L9.6 12L7 14.7'),
+                       P('M10.6 14.7H13.4'),
                      ]),
 
   'help-docs':       I([ C(10,10,8), P('M7.5 7.8q0-2 2.5-2t2.5 2q0 1.5-2.5 2.5v1', 1.5), Cf(10,14.7,0.7) ]),

docs-site/src/content/docs/data-exchange/codev-coatings.md

@@ -0,0 +1,66 @@
+---
+title: CODE V Coatings
+description: Read and write CODE V MULTILAYER (MUL) coatings, importing the layers of a .seq or .mul file into a design or the Coating Library, or exporting the active design as a .seq file.
+ribbonIcon: codev-coatings
+---
+
+The **CODE V Coatings** window moves a coating between TFStudio and CODE V. It reads a CODE V MULTILAYER (`MUL`) coating, either the `.seq` command file that enters the stack or the `.mul` file CODE V saves from it, and writes one side of the active design as a `.seq` file that CODE V runs to make the `.mul`. Import and export are on separate tabs in one row. What the last action did shows at the right-hand end of that row, beside a warning badge: on the Import tab it holds what was noted while reading the file, on the Export tab what the export noted about the preview.
+
+## Settings
+
+**Open .seq or .mul** (Import tab, in the panel on the left): reads a coating file. The panel then shows the incident medium and the substrate in the file, the wavelengths, the angles and the reference wavelength. Beside it are the file's title and its layers from the incident medium to the substrate, with their thickness in nm and a lock on each layer CODE V holds fixed (code 100).
+
+**Import → front coating** and **Import → back coating** (Import tab): the file's layers replace the front or the back coating of the active design, and the design keeps its incident medium, exit medium and substrate; the file's `INC` and `SUB` are shown, not applied. The materials the layers use go into a user catalog named `CODE V` and the file name. With no design selected there is nothing to import into, so both buttons are off, while **Save to Coating Library…** stays on.
+
+**Save to Coating Library…** (Import tab): saves the stack into My coatings, through the same dialog as **Save current coating…** in the [Coating Library](/design/coating-library/). The saved coating lies between the file's `INC` and `SUB`: an index of n 1 with no k is saved as Air, and any other index or `MIC` material as the material the import makes of it. Its layers are the ones **Import → front coating** puts on the design. The band starts at the span of the file's analysis wavelengths, or at the band [Optical Evaluation](/analysis/optical-evaluation/) is set to when the file has one wavelength, and the angle at its first `ANG`. The materials are carried in the saved coating, so it works on a computer that never opened the file, and saving adds nothing to your material catalogs.
+
+**Side** (Export tab): **Front** writes the design's incident medium, the front coating and the substrate. **Back** writes the exit medium as the incident medium, then the back coating from the exit side to the substrate, then the substrate, because CODE V wants air as the incident medium and the glass as the substrate on either face of an element.
+
+**Title (TIT)**: the coating title, up to 80 characters. It starts as the design name.
+
+**File name (SAV)**: the name of the `.mul` file the last command of the `.seq` writes. **Save .seq** offers the `.seq` under the same name.
+
+**REF (nm)**: the reference wavelength written to `REF`. It starts at the design's reference wavelength.
+
+**Analysis wavelengths, WL**: from, to and step in nm, with the number of wavelengths shown beside them. CODE V takes up to 100, and a larger count is refused before anything is written.
+
+**Angles of incidence, ANG**: up to five angles in the incident medium, each from 0 up to but not including 90 degrees, decimals allowed. An entry outside that range goes back to the angle the field held. The plus button adds one, the cross removes one.
+
+**Generate preview** builds the file and shows it in full; **Save .seq** writes it. A design with a material that cannot be found on this computer cannot be exported until the material is replaced. With no design selected there is nothing to export, and the Export tab shows nothing but a request to open or create one.
+
+## How to read it
+
+From a `.seq` file the import reads the stack entered in the `MDA` sub-option: `PHT`, `TIT`, `WL`, `WLG`, `REF`, `ANG`, `INC`, `COA`, `GRO` and `END` groups, `SUB` and the `MIC` catalog. The analysis, plot and optimization options and the file commands are passed over; any other command is skipped, and the warning badge names it. CODE V reads at most 21 values from one `WL`, `MWL` or `EXT` command or one `MIC` material line and ignores the rest, and the import keeps the first 21 the same way, with a warning. A `.mul` file is read as CODE V saved it, both the sample coatings that come with CODE V and the files CODE V 11.2 saves.
+
+A file that writes its numbers with a decimal comma (`403,03`) imports with a warning. The import reads a comma between two digits as a decimal point, but CODE V does not read such a number, so the file does not run in CODE V as it is.
+
+`WLG` builds its wavelengths the way CODE V does, in single precision, so a wavelength can sit slightly off the round value. The window shows the wavelengths and `REF` with only the digits that precision holds: `WLG 400 800 10` shows as 400 to 799.9997 nm, and with no `REF` in the file the reference wavelength shows as 599.9998 nm.
+
+A thickness entered in waves (`PHT N`) is converted to nm with the layer's n at `REF`, or at the central analysis wavelength when the file has no `REF`, which is what CODE V takes then. An imported `MIC` material is tabulated over the span of its `MWL` points, the analysis wavelengths and `REF`, with n and k that follow CODE V 11.2's interpolation of its table, between the `MWL` points and past them. When `REF` lies outside a `MIC` table that a layer entered in waves uses, a warning names the material.
+
+The front coating takes the layers in the order the file lists them. The back coating takes them with the file's first layer on the exit side and its last against the substrate, the order the export writes a back coating in. When [**Symmetric (back = front)**](/design/evaluation-modes/) is ticked, the back coating is the mirror of the front, so only **Import → front coating** is available.
+
+A layer CODE V holds fixed (code 100) is imported locked. A layer coupled to others (code 1 to 99) is imported free, since TFStudio has no coupled layers, and the report says how many there were.
+
+Importing the same file again uses its catalog, and a material the catalog already holds is kept as it is, edits included. Undo puts the coating back as it was before the import; the catalog and the materials added to it stay.
+
+What CODE V accepts, from the MUL chapter of its help, and what the export does about each limit:
+
+| Item | CODE V | On export |
+| --- | --- | --- |
+| Layers | up to 1000 | refused above 1000 |
+| Analysis wavelengths, `WL` | up to 100 | refused above 100; written at most 21 to a `WL` command, the most CODE V reads from one |
+| Angles, `ANG` | up to 5 | the field holds five |
+| Points per `MIC` material, `MWL` | up to 21 | a material is sampled at the analysis wavelengths; above 21, the points kept are added one at a time where CODE V's own interpolation misses the material most, until it matches every wavelength to the 6 decimals written or 21 are kept, and a warning names the material |
+| Material label | 6 characters | made from the material name, with a number added when two labels would be the same |
+| Incident medium and substrate | n only | the k of an absorbing medium is dropped, with a warning |
+| Thickness | physical nm (`PHT Y`) or waves at `REF` (`PHT N`) | physical nm, `PHT Y` |
+| Fixed layer | code 100 | a locked layer is written with 100, any other with 0 |
+
+A material whose n and k do not change over the analysis wavelengths is written as a number on its `COA` line rather than as a `MIC` entry. k is written as a positive number. CODE V enters layers from the incident medium to the substrate, while the Design Editor numbers them from the substrate, so the Design Editor's layer 1 is the last `COA` line of the file.
+
+The file ends with `SAV`, so running it in CODE V writes the `.mul` that `MLT` attaches to a lens surface. Once the coating is on a lens surface, CODE V takes the substrate index from the lens, so `SUB` matters only inside `MUL`.
+
+## References
+
+- CODE V Multilayer Design Reference Manual, chapter "Multilayer Coating Design and Analysis (MUL)": *MDA Sub-Option* for the commands and their limits, *Technical Notes* for the order of the media on each kind of surface.

docs-site/src/content/docs/data-exchange/measured-ellipsometry.md

@@ -56,7 +56,7 @@ section of the formats page.
 An opened file belongs to the design selected in the project explorer. Select
 another design and the window shows that design's curves and nothing of the
 file; come back and the file is where you left it. With no design selected
-there is nothing to import into, and the button is off.
+the window shows nothing but a request to open or create one.
 
 ### Configuring the columns
 

docs-site/src/content/docs/data-exchange/measured-spectra.md

@@ -21,7 +21,7 @@ instrument quirks it handles on its own, is on the
 An opened file belongs to the design selected in the project explorer. Select
 another design and the window shows that design's curves and nothing of the
 file; come back and the file is where you left it. With no design selected
-there is nothing to import into, and the button is off.
+the window shows nothing but a request to open or create one.
 
 ### Confirming the parse
 

docs-site/src/content/docs/data-exchange/report-generator.md

@@ -30,7 +30,7 @@ The **Template** list holds three: Design record, the default, with everything i
 
 ## Several designs
 
-Pick more than one design under **Designs** and the report becomes a comparison. The designs are lettered A, B, C and listed with their full names in a key under the masthead; tables, plot legends and recipe headings refer to them by letter, so a long name never widens a column. Facts, verdicts, integral values and color render as one table with a column per design, six designs to a table, the spectrum block draws every design on one plot, and the recipes sit side by side. Blocks without a comparison form render once per design.
+Pick more than one design under **Designs** and the report becomes a comparison. The designs are lettered A, B, C and listed with their full names in a key under the masthead; tables, plot legends and recipe headings refer to them by letter, so a long name never widens a column. Facts, verdicts, integral values and color render as one table with a column per design, six designs to a table, the spectrum block draws every design on one plot, and the recipes sit side by side. Blocks without a comparison form render once per design. With no design open the report covers only the designs picked under **Designs**; with none picked there is no page, only a request to open or create a design.
 
 ## Export