메뉴
Load an IVAS-style .rrng (or .rng) range file onto an existing mass spectrum, recreating all its ion ranges (and their colors) on the plot. Use when the user has a .rrng/.rng file and wants to apply those ranges instead of defining them by hand.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | apt-load-rrng |
| description | Load an IVAS-style .rrng (or .rng) range file onto an existing mass spectrum, recreating all its ion ranges (and their colors) on the plot. Use when the user has a .rrng/.rng file and wants to apply those ranges instead of defining them by hand. |
| argument-hint | <file.rrng> |
Load a .rrng / .rng range file and add every range it defines to the current mass spectrum spec. Use the MATLAB MCP server.
The MATLAB workspace must contain:
spec — an open mass spectrum figure (from /apt-spectrum, e.g. spec = massSpecPlot(pos, 0.01)). The ranges are drawn onto this figure.colorScheme and isotopeTable — loaded by /apt-setup (or load('colorScheme.mat') and load('isotopeTable_naturalAbundances.mat')).If spec does not exist, tell the user to run /apt-spectrum first.
$ARGUMENTS is the path to the .rrng/.rng file. If a path is given, use it directly; otherwise let the user browse:
[file, path] = uigetfile('*.rrng');
The file-picker dialog is a manual GUI action — tell the user to select the file in the dialog. (If $ARGUMENTS is supplied, instead set path = ''; file = '<file.rrng>';.)
Make sure the lookup tables are available:
load('colorScheme.mat')
load('isotopeTable_naturalAbundances.mat')
elements = elementsExtractFromText(fileread([path file]));
ionList = ionsCreateComplex(elements, [1 2], isotopeTable, [1 2 3]);
ionsCreateComplex(elements, complexity, isotopeTable, chargeStates) here builds mono- and di-atomic complexes (complexity = [1 2]) for charge states 1-3 ([1 2 3]).
rrng = string(splitlines(fileread([path file])));
rrng(rrng == "") = [];
useRrngColor = true; % use the colors stored in the .rrng file (set false to auto-assign)
for i = 1:length(rrng)
[mcBegin, mcEnd, ionName, ionVolume, ionColor] = rangeInfoFromRRNG(rrng(i));
if not(isempty(mcBegin))
[h, txt, colorScheme] = rangeAddFromRangeInfo(spec, colorScheme, isotopeTable, ...
ionList, mcBegin, mcEnd, ionName, ionVolume, ionColor, useRrngColor);
end
end
rangeInfoFromRRNG returns empty mcBegin for non-range lines (headers, comments), which are skipped. rangeAddFromRangeInfo draws each range and may extend colorScheme with any new ion colors, so reassign it as shown.
Tell the user how many ranges were added to spec and confirm colorScheme may have gained new ions from the file. Note that useRrngColor = true preserves the original IVAS colors.
Suggest follow-ups:
rangeTable = rangesExtractFromMassSpec(spec);/apt-compositionrangeAdd(spec, colorScheme).elementsExtractFromText, ionsCreateComplex, rangeInfoFromRRNG, rangeAddFromRangeInfo; uigetfile, fileread, splitlines (MATLAB built-ins). Follow-ups: rangesExtractFromMassSpec, rangeAdd.
Voronoi-cell cluster determination (Felfer et al. 2015) — detect and extract clusters via Voronoi-cell volumes, Delaunay triangulation, and a Kolmogorov-Smirnov test against a randomised reference. Use when the user wants the Voronoi/clusterDetermination method specifically (this is NOT DBSCAN — for density-based DBSCAN use /apt-cluster instead).
Create a new ion color scheme or add ions/colors to the existing one. Produces/updates the `colorScheme` workspace variable used by ranging and 3D visualization everywhere else. Use when the user wants custom ion colors, a new color scheme, or to add a missing ion color.
Per-vertex concentration mapping onto a mesh/interface — compute atom-to-mesh distances, clip a slab around the interface, voxelise by nearest vertex, and apply a concentration kernel to colour each vertex. Use when the user wants a concentration map painted onto an isosurface or modelled grain boundary mesh.
Run quality-control checks on an atom probe dataset before analysis — basic stats, voltage curve, detector hit map (FDM), mass spectrum sanity, coordinate ranges, multi-hit fraction, and automated quality metrics. Use when the user wants to assess data quality or sanity-check a reconstruction.
Create a field desorption map (detector hit-density / concentration image) and optionally a movie of detector activity over the course of the experiment. Use when the user wants an FDM, desorption map, detector image, or to watch features evolve during the measurement.
Quantify interfacial excess (Gibbsian excess of solute, in at/nm^2) across an interface — either a single value via the Krakauer-Seidman integral method, or a 2D excess map over the surface. Use when the user wants the amount of an element segregated to an interface or grain boundary.