Fix typos

CLAUDE.md

@@ -64,7 +64,7 @@ illuminated and is not subject to phosphor persistance or decay.
 Exceptions:
 
 Graticule text: should be incandescent for the bearing marks. 
-Graticale text for all a-scope should be incandenecent, not white
+Graticule text for all a-scope should be incandescent, not white
 and not phosphor as they are dependent on glass graticules with etched
 lines and text.
 
@@ -77,9 +77,9 @@ Maximum Range is 6 miles for marine type radar
 Maximum Range is 20 miles for air traffic control radar.
 Maximum Range is 100 miles for chain home
 Maximum Range 10 miles for precision approach radar; graticule is
-  incandescent showing the azimouth path and elevation path as describe
+  incandescent showing the azimuth path and elevation path as described
   below in PAR description. Those graticules are etched glass for minimal
-  parralax
+  parallax
 
 The proposed location of the marine radar antenna is in the middle of Bellingham
 Bay on a 100 foot platform. (This should be mentioned as fictitous in the description)
@@ -92,27 +92,27 @@ The proposed location for the chain home would be at the original location on
 the UK coast facing the European Continent
   
 The following types of scope will be used; (note that these are not all
-going to show at once. They will be selectable using a push button (a letter 
+going to show at once. They will be selectable using a push button (a letter on
 the keyboard until I get physical buttons that are connected to a gpio pin.
 The selection key should be s (short for scope)
 
-PLease note that all keyboard based controls need to be described in each
+Please note that all keyboard based controls need to be described in each
 scope's left hand text panel. These are different for each scope. Note that
 the s for selecting a scope should be in each scope's description and what
 would the next scope be.
 
-Also not that when the radar exhibit starts, the very first option will
+Also note that when the radar exhibit starts, the very first option will
 be on the screen. Then the screen will advance through the scopes by two means;
 the pressing of the s key by the user, or automatically at every 120 seconds. You will
-need to emphasize in the first desciption that you can advance without waiting
+need to emphasize in the first description that you can advance without waiting
 for the automatic advancing by pressing the s key. You can reverse by hitting the S key
 (upper case s) This should be articulated for the
-discrition window for each scope. When the main exhibit descriptor screen comes up, it's 
+description window for each scope. When the main exhibit descriptor screen comes up, it's 
 important to highlight the feature that the user can press the s key or the S key any time to 'hurry up'
 the scope advancement.
 
 Also ensure that the timeout clock will reset when the user changes to a new scope, or presses
-any key or operate any control on the panel. This
+any key or operates any control on the panel. This
 should be articulated in the descriptive text
 
 
@@ -121,19 +121,19 @@ should be articulated in the descriptive text
       be in all caps, "WELCOME TO MUSEUM VINTAGE RADAR EXHIBIT"
 
    2. Marine A-Scope - (horizontal axis is range; vertical axis is amplitude of
-      return pulse; bearing will be set via a bearing control; current implimentation
+      return pulse; bearing will be set via a bearing control; current implementation
       would be two keys on the keyboard; one key to go clockwise on bearing and another
       key would be to go counterclockwise. The A scope phosphor is P1, which is green.
       The c key for clockwise on a scope and v for counterclockwise.
       The step rate for this control, before the knob is implemented would be one or two
       degrees per key press, but if the key is held down, it would increase slowly due to
-      how long the keep is depressed
+      how long the key is depressed
 
       The A scope graticule is manually swapped out at each maximum range value 
       by the operator during the period. Here we will have to fake it out. And that
       graticule needs to have an incandescent color. That graticule will have three horizontal
       graticule lines for estimating return pulse strength. The range lines (vertical lines)
-      should mush match the interim and final ranges as selected by the max range selelction
+      must match the interim and final ranges as selected by the max range selection
       To change maximum range, use key u for up and d for down. Possible settings are 2,4,6
       miles; this must be noted clearly on the description text.
 
@@ -161,19 +161,19 @@ should be articulated in the descriptive text
   3. Chain Home A Scope There is a second use of the a-scope. 
       That is for the early world war 2 chain home
       radar. This operated very differently. You have a large array of high power transmitters
-      'floodlighting' the target area (in world war 2, that would be the english channel. 
+      'floodlighting' the target area (in World War 2, that would be the English Channel. 
-      Since we don't care about land reflactions with the original chain home setup was
+      Since we don't care about land reflections with the original chain home setup was
-      facing the englash channel, we can tell visitors that this radar is set at the
+      facing the English Channel, we can tell visitors that this radar is set at the
-      english channelk (do this explanation on the explantation side panel for this
+      English Channel (do this explanation on the explanation side panel for this
       radar mode. And for simulating operator using this radar, there would be two controls,
       one for the 'nulling the signal at the correct direction; simulating the behavior 
       of the goniometer and the other for using the goniometer for elevation. For museum
       accuracy, we need to simulate the sharp 'null' when the goniometer is at the direction
       of the signal. This concept needs to be covered in the description text thoroughly
-      as this is a bit advanced. I need your advise to how to do this for children and those
+      as this is a bit advanced. I need your advice on how to do this for children and those
       who never heard of chain home. 
 
-      The goniometer vertical and horizontal switch could be key [ for toggling. The gonometer tuning
+      The goniometer vertical and horizontal switch could be key [ for toggling. The goniometer tuning
       would be 9 and 0 to avoid using the shift key. The tuning keys should have one unit
       for single  press, but a slow build of of speed if key is held down. This has to stay
       slow due to the sudden appearance of the null.
@@ -191,8 +191,8 @@ should be articulated in the descriptive text
       goniometer.
 
       The refresh rates for chain home were slow in order to avoid aliasing with targets
-      far away, the pulse repitation frequency (PRF) is about 25 times per seconds. This
+      far away, the pulse repetition frequency (PRF) is about 25 times per second. This
-      rate is 1/2 of the standard 50 hz for brittish power.
+      rate is 1/2 of the standard 50 Hz for British power.
 
       The operator did have a switch to switch from the 25 pulses per second PRF to 12.5
       pulses per second PRF so that they could help eliminate teh range ambiguity
@@ -203,7 +203,7 @@ should be articulated in the descriptive text
       the PRF in order to reduce confusion caused by other radio transmissions such as press-to-talk
       communications transmissions. 
 
-      Lets assign key . for toggling between 25 and 12.5 PRF. There is no range selection. 
+      Let's assign key . for toggling between 25 and 12.5 PRF. There is no range selection. 
       Note on description; this is to reduce  use of the shift key.
 
       Because of the slow repitition rate, the phosphor used was a early implementation
@@ -216,12 +216,12 @@ should be articulated in the descriptive text
       shrink the electronic trace so tht the 10 mile pips align perfectly with the 10 mile
       marks on the edge lit glass graticule.
 
-      Lets assign keya n for shrink and m for stretch. (may be ambiguous, but I am running
+      Let's assign key n for shrink and m for stretch. (may be ambiguous, but I am running
       out of keys. Note in the descriptor.
      
 
    4. Marine PPI Scope - 
-      maring scopes have the following items in common:
+      marine scopes have the following items in common:
            Targets, range rings, and range ring text levels shall be treated the same for
            presentation. All are P7 phosphor. Immediatel strike by the electron beam is blue.
            persistance is green/yellow. Targets, range rings, and range ring labels shall all
@@ -263,7 +263,7 @@ should be articulated in the descriptive text
            a plastic overlay in the period time. Two controls control the  cursor; range and
            bearing. Both were physical crank controls. For now, both we need to use key pairs
            on the keyboard. A white text indication of range and bearing should be put under 
-           the scope. In the real day, it was a machanical readout. The key sewuence would be
+           the scope. In the real day, it was a machanical readout. The key sequence would be
            r for bearing to the right and l for bearing for the left; and t for higher range
            and y for smaller range. These controls should have slow movement for single stroke; but
            gradual for for holding key down.
@@ -283,7 +283,7 @@ should be articulated in the descriptive text
            miles.
 
            Air Traffic Control:
-           Max is 5; one interim rainge; two total; rings at 2.5; final ring at 5
+           Max is 5; one interim range; two total; rings at 2.5; final ring at 5
            Max is 10; four interim ranges, five total; 2,4,6,8; final ring at 10
            Max is 15; three interim ranges four total; 4,8,12; final ring at 15
            Max is 20, three interim ranges four total; 5,10,15; final ring at 20
@@ -311,27 +311,27 @@ should be articulated in the descriptive text
            a plastic overlay in the period time. Two controls control the  cursor; range and
            bearing. Both were physical crank controls. For now, both we need to use key pairs
            on the keyboard. A white text indication of range and bearing should be put under 
-           the scope. In the real day, it was a machanical readout. The key sewuence would be
+           the scope. In the real day, it was a machanical readout. The key sequence would be
            r for bearing to the right and l for bearing for the left; and t for higher range
            and y for smaller range.
            These controls should have slow movement for single stroke; but
            gradual for for holding key down.
 
    6. Precision approach (PAR for short)
-      PAR was developed in WWII and matured in the 1950s. With a fixec 10 mile range, it was
+      PAR was developed in WWII and matured in the 1950s. With a fixed 10 mile range, it was
       controller who talked the pilot down verbally over radio, which means that the pilot
       does not have to rely on any equipment on the plane itself to help with landing.
       The display shows the full 10-mile approach path, but the controller's active guidance window
       is roughly the last 5 miles, intensifying from about 2 miles out to touchdown.
       This needs to be carefully explained on the explainer screen.
-      Lets locate this at the south end of Runway 16/34 landing at BLI and lets have the
+      Let's locate this at the south end of Runway 16/34 landing at BLI and let's have the
       active runway 34 (northbound landing)
 
       Locate at the end of Runway 16/34
       at Bellingham Airport (BLI). Two vertically stacked scopes share the
       right panel. Top scope: azimuth (lateral deviation vs. range from
       touchdown). Bottom scope: elevation (vertical deviation vs. range).
-      Have the azimouth scope to about 1/3 larger than the elevation scope
+      Have the azimuth scope to about 1/3 larger than the elevation scope
       Both use P7 phosphor; graticules are incandescent etched glass.
       Range: 10 miles maximum, fixed (no range change control).
       Non-linear scale: inner 5 miles occupies 70% of horizontal width.
@@ -396,11 +396,11 @@ SUMMARY OF Controls:
   │ m   │ Calibrator stretch                  │       │          │      ✓       │            │         │     │
   └─────┴─────────────────────────────────────┴───────┴──────────┴──────────────┴────────────┴─────────┴─────┘
 
-Table for general controls not implimented on the keyboard in the table above:
+Table for general controls not implemented on the keyboard in the table above:
 
 1. Intensity
 2. Focus
-3. Astignetism
+3. Astigmatism
 4. Gain
 5. rain clutter
 6. water wave clutter
@@ -409,13 +409,13 @@ Table for general controls not implimented on the keyboard in the table above:
 SUMMARY of target handling:
 
 The traffic cop handles anything that is coming from the simulator as well as the raspberry pi's
-It will use pollnig to find if anything is available from the raspberry pis and the simulator. It will
+It will use polling to find if anything is available from the raspberry pis and the simulator. It will
 poll each source once per beam update
 
 The raspberry pi receiver pulls the data from each raspberry pi. If nothing, it does nothing else 
 for this sweep. If there is data, it will provide data to the traffic cop upon poll.
 
-Each raspberry pi, after boot-up, will respond to poles from the raspberry pi receiver (thread 2)
+Each raspberry pi, after boot-up, will respond to polls from the raspberry pi receiver (thread 2)
 
 The Simulator will run all fake targets. It will provide data to the traffic cop upon traffic cop poll.
 It can run as a separate thread. It will not write data to anywhere except when polled by the traffic cop.
@@ -459,9 +459,9 @@ On the left hand of the window will be a text description of that scope.
 Underneath each scope's description will be cursor range and bearing from the radar
 location; and the setting of maximum range; and the bearing offset; for 0 would
 be to have 0 degrees pointing to true north (this is needed if I decide to
-implement a radar on a boat. If implimented, use k for bearing to right; and
+implement a radar on a boat. If implemented, use k for bearing to right; and
 j for bearing to left. Make note in description that this is only used if this
-is a radar on a boat. (perhaps later on, I could ad a PPI on a boat scenario)
+is a radar on a boat. (perhaps later on, I could add a PPI on a boat scenario)
 
 Please note that some keys may be the same from scope to scope. This is okay. Each
 scope's controls are for that scope that you are connected do.They will not effect
@@ -471,8 +471,8 @@ Please note that the maximum range setting on a scope specific to that scope
 and will be in that scope's definition. and the bearing selection
 is scope specific. The manually operated radar dish for the a scope is not the same
 as the PPI radar dishes. They are from different eras. In addition, all range and
-bearing data for marine is separate than for air traffic control. They are completly
+bearing data for marine is separate than for air traffic control. They are completely
-different radars. Range and bearing for the precision aproach radar will be different
+different radars. Range and bearing for the precision approach radar will be different
 than any other radar as that radar is located at the end of the runway and scan both
 horizontal and vertical.
 

additions

@@ -9,22 +9,28 @@ a postgresql user named radar with password radar with full priveleges to databa
 DATABASE Schema:
 
 1. Type of target (Enumeration AIS, ADS-B, Local (simulator)
-2. ID a. MMID for marine; b. ICAO 24 bit aircraft address; for simulator we can use the same MMID
+2. ID a. MMSI for marine; b. ICAO 32 bit aircraft address; for simulator we can use the same MMSI
    and aircraft address
-3. width (24 bits)
+3. width (32 bits) in meters (float data type)
-4. length (24 bits)
+4. length (32 bits) in meters (float data type)
-5. Height above water (24 bits)
+5. Height above water (32 bits) in meters (float data type)
 6. Material (Enumeration fiberglass, wood, aluminum, steel
-7. Enumeration: need update for size and material, does not need update for size and material
+7. boolean: need update for size and material, does not need update for size and material
+8. ISO 8601 timestamp for last used
+9. ISO 8601 timestamp for last updated
+10. Track / position history (to be used if I want newer track prediction radars
 
-Keep a copy of the data in the shaders. Don't just copy the entire database; when the
+For performance, we can keep id, width, length, and height, and material
-system starts up, there would be nothing in the copy; but as we get targets, either from
+inside the shaders as fixed data; but have location, heading, and altitude (aircraft)
-AIS, ADS-B, or simulator, add each target encountered to the copy in the shaders. This means
-that we don't have to copy all of the data into the database. It will grow to a size up to the
-current target count in a simulation session.
 
 The items in the database (to start with) would be the Enumeration, The ID, width, height,
-and material.
+and material. Suggestion: Uniform Buffer Object for the id, width, height, material
+
+The items that are updated per data coming in from the raspberry pis and the simulator
+are orientation / RCS (based on heading),  location (in longitude and latitude) and ID ; Suggestion
+vertex objects or SSBO
+
+Suggest that CPU compute the RCS based on heading and dimensions and altitude (aircraft) 
 
 Maybe,  if I simulate a modern system, I may want a field to describe the target (passenger, cargo,
 oil, fishing; and maybe specifics for the targets. I know that the coast guard has a lot of
@@ -49,7 +55,7 @@ END OF PROPOSAL
 Marine radar equation stuff:
 
 For this purpose, the marine radar will use the X Band (9225 MHZ) and 30 KW power for
-maratime traffic system radar (our a-scope marine and PPI scope marine)
+maritime traffic system radar (our a-scope marine and PPI scope marine)
 
 For Marine, horizontal beam width is 0.5 degrees; vertical beam width is 20 degrees. 
 For Marine, the antenna size is 15 feet in length.
@@ -70,12 +76,12 @@ Chain Home radar equation stuff:
 For Chain Home, this will be a bit different: (this is AMES type 1)
 
 Frequency is 30 MHZ
-Powwer is 500 KW
+Power is 500 KW
 Pulse width is 20 US
 
 TRANSMIT GAIN (Gt)
 Note that the transmit beam is not a beam, but a floodlight.
-Pulse repitation frequency is 25 HZ or 12 HZ as selected by operator
+Pulse repetition frequency is 25 Hz or 12.5 Hz as selected by operator
 Use Transmit G from beam width (floodlight) something like
 G = 30000/100 degrees * 40 degrees
 about 8.7 dBI (linear value of 7.5
@@ -93,7 +99,7 @@ Precision Approach Radar Equation Stuff:
 Peak power is about 100 kw
 Very high antenna gain
 X Band (3 cm for wavelength) Operation allow higher antenna gain 
-PAR must reliably small aircraft
+PAR must reliably detect small aircraft
 High pule repition rate
 Sweep about 20 degrees horizontal and 10 degress vertical
 Short pulse width for range resolution