maallyn/updated-radar
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Update CLAUDE.md: simplify controls per museum consultation, fix grammar

Browse Source 
Removed PRF, calibration strobe, and pulse width controls per museum feedback.
Added screen layout description, Introduction scope, startup behavior, and
panel controls clarification. Fixed grammar, typos, and word choice throughout.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
Mark Allyn
2026-05-06 21:39:35 -07:00
parent a2d2cfee1b
commit 93e30d8433
1 changed files with 30 additions and 46 deletions
Download Patch File Download Diff File Expand all files Collapse all files

76
CLAUDE.md
View File

@@ -40,6 +40,7 @@ I will run the code while physically using the Geekom.
Please add MIT license header to each file Please add MIT license header to each file
Please add Author: Mark Allyn to each file Please add Author: Mark Allyn to each file
Use snake_case for variables and PascalCase for classes Use snake_case for variables and PascalCase for classes
use #pragma once use #pragma once
Use // for single line comments Use // for single line comments
@@ -48,36 +49,48 @@ avoid using auto
Summary of project: Summary of project:
This is a museum exhibit displaying and providing interaction This is a museum exhibit displaying and providing some interaction
of vintage 1940's, 1950's, and 1960's radars. A key objective is to of vintage 1940's, 1950's, and 1960's radars. A key objective is to
provide interaction and viewing of the frustrations of using provide interaction with and viewing of radars from that era.
radars in that era. The different radars are:
There will be three main areas of the screen. On the right hand side will be the radar
scope.
On the left hand side of the screen will be a text description of the scope as well
as the controls of the scope and keyboard keys for each control. This text will be
white while the control labels will be red and the keystrokes will be in pink.
At some point, pending a decision with the museum, we may purchase components to mount the controls on a panel. Until that is done, the controls will be on the keyboard.
Below the scope will be a text status window. This text will be yellow
Scopes in the right panel Scopes in the right panel
1. A-scope for Chain Home Radar in the 1940's (first radar and could be tricky) 1. Introduction of Exhibit (Explanation of the project on the left hand text panel.
2. A-scope for marine radar in the 1950's (Before PPI radar); was a bit tedious to operate 2. A-scope for Chain Home Radar in the 1940's (first radar and could be tricky)
3. PPI scope for marine traffic control (uses beam sweeping in all 360 degrees of 3. A-scope for marine radar in the 1950's (Before PPI radar); was a bit tedious to operate
4. PPI scope for marine traffic control (uses beam sweeping in all 360 degrees of
rotation); Easier to use than a scope rotation); Easier to use than a scope
4. PPI scope for air traffic control; similar to PPI scope for marine, but with different range 5. PPI scope for air traffic control; similar to PPI scope for marine, but with different range
5. PPI scope on board a boat. Shows how movement of a boat affects the radar display 6. PPI scope on board a boat. Shows how movement of a boat affects the radar display
6. Precision Approach Radar (Two scopes; one showing horizontal movement of a plane 7. Precision Approach Radar (Two scopes; one showing horizontal movement of a plane
in the glide path toward the runway, and the other showing vertical movement of a plane in the glide path toward the runway, and the other showing vertical movement of a plane
as it glides vertically down to the runway). Both scopes will be seen if this is selected. as it glides vertically down to the runway). Both scopes will be seen if this is selected.
Please note that these scopes will not appear all at once. The selection of which scope Please note that these scopes will not appear all at once. The selection of which scope
the visitor sees is done by pressing a forward control and a reverse control to go around the visitor sees is done by pressing a forward control and a reverse control to go around
the loop of scopes. the loop of scopes. The first display when the system is turned on or booted up is the
Introduction of the exhibit.
Please note that the first iteration of the project will have only minimal controls.
This is a suggestion I got after meeting with the museum staff. Perhaps later we may
add more controls.
Also, please note that the state of the controls of each scope is independent of any Also, please note that the state of the controls of each scope is independent of any
other scope. Furthermore, the controls will reset when a scope is exited and then re-entered. other scope. Furthermore, the controls will reset when a scope is exited and then re-entered.
The Text window in the left panel for descriptions of the scopes and a listing of controls
Controls to affect the behavior of the scopes; (these first implemented using keyboard Controls to affect the behavior of the scopes; (these first implemented using keyboard
strokes; later when physical controls are completed, the keyboard controls will be removed) strokes; later when and if physical controls are completed, the keyboard controls will be removed)
These controls will affect the state variables and the uniform variables of the shaders.
The controls will affect state variables that will be sent to the shaders as uniforms.
There will be three abstracts for scopes: There will be three abstracts for scopes:
@@ -87,11 +100,13 @@ There will be three abstracts for scopes:
The basic controls for both A Scopes include: The basic controls for both A Scopes include:
Intensity (the overall brightness of the entire display). Intensity (the overall brightness of the entire display).
Sensitivity (the strength of the signal amplification of the Sensitivity (the strength of the signal amplification of the
receiver). This has nothing to do with the brightness of the receiver). This has nothing to do with the brightness of the
pulses. This only affects the height of the pulse and the height pulses. This only affects the height of the pulse and the height
of any noise floor. of any noise floor.
Chain Home A Scope Chain Home A Scope
Because the receiving antennas are very large (about 100 feet), the Because the receiving antennas are very large (about 100 feet), the
@@ -125,26 +140,9 @@ There will be three abstracts for scopes:
The range is 200 miles. The range is 200 miles.
There is also a selection for the pulse repetition frequency (PRF). A switch was
used to select one of two PRFs. One is 50 pulses per second and the other is 25
pulses per second. This selection should also be indicated in the status text
below the scope. We need to have a keyboard selection to cycle this selection
as well as a switch on the control panel.
There is a glass or plastic graticule that is etched with vertical lines There is a glass or plastic graticule that is etched with vertical lines
representing range. This is edge-lit with incandescent lamps. representing range. This is edge-lit with incandescent lamps.
Because of natural drift of period electronic components, they needed an
electronic calibration, or strobe.
This is a crystal oscillator which is
steady and precise.
The pip generated by this circuit can be moved via knob or keyboard keys and
its position is indicated on the text status line below the scope.
The operator aligns this pip with a target pip in order to get an accurate
range to the target.
Marine A Scope Marine A Scope
Marine radar frequencies allowed the use of much smaller antennas; Marine radar frequencies allowed the use of much smaller antennas;
@@ -168,11 +166,6 @@ There will be three abstracts for scopes:
Following the width, the pip has a finite fall time as the transmitter stops. This Following the width, the pip has a finite fall time as the transmitter stops. This
creates a curved waveform; not just a line. creates a curved waveform; not just a line.
Here is some information on the pulse width for these old A Scope Marine Radars. There is
a switch that selects two pulse widths. Option 1 is Short Pulse (0.1 microsecond) for harbor
navigation and Option 2 is Long Pulse (1 microsecond) for open sea detection. We need
to implement this control. Perhaps a single keyboard key or single physical button.
Range and range lines on graticule Range and range lines on graticule
Please note that the graticules are plastic overlays over the screen. They need to be removed Please note that the graticules are plastic overlays over the screen. They need to be removed
@@ -192,15 +185,6 @@ There will be three abstracts for scopes:
Range can be selected with two keyboard keys or two buttons on the panel, and is Range can be selected with two keyboard keys or two buttons on the panel, and is
indicated in the text status panel below the scope. indicated in the text status panel below the scope.
Please note that the range setting and the pulse width are separate controls.
There are two reasons.
1. Target discrimination and detection. Short pulse results in better range resolution while
a longer pulse width results in better detection of distant and weak targets.
2. Magnetron Duty Cycle. Too much time with long pulse width can put a strain
on the magnetron.
2. PPI Scope - still being worked 2. PPI Scope - still being worked
3. PAR Scope - still being worked 3. PAR Scope - still being worked