0D54NcPT Notes and Documentation

Documentation for https://pastebin.com/0D54NcPT

I'm removing the revision notes and superfluous comments from the Draconic Reactor Monitor program, and consolidating those here.

This pastebin will be referenced from the program instead.

New notes added 8-6-2021
Recent additions moved the power increase to the correcting section to do micro increases rather than the periodic 10k increases.
I've noticed at around 90-95% the temp goes up, between 8000-8500 in particular you'll start to lose containment, the
program should shut down if it gets to 45%, however you can probably milk a little more chaos out of that last 5% if I add another
modem and increase the high size flux gate to the injector by maybe 10k when it gets to 48%, should it get to 45 it should
go ahead and scram.

I've gotten the temp up to 8656 confirmed with 2,109.013 RF/t, however I'm manually tweaking the flow to the field.  that will come in
1.3

For now the notes verbatim are below:

-- modified to work with draconic rf storage (trying to determine actual 'gain' from reactor)
--Rev 20210630 wtp as prev. rev didn't change anything it was the motivation for today's changes
--so the version will be held at 1.2
--Add 50 samples of gain/loss for ~100 seconds of historical energy saturation fluctuations
--Add file io and log functions, logged a few key events (config, increase, scram)
--Correct time function to work with 24H GMT from new source
--Contrary to what might be below, the config file values.cfg should now contain only two lines
--fluxgate and fluxgate_out, in that order, as whatever value is reported when your modem is connected
--Note that fluxgate out is NOT the gate to the injector, I don't mess with that one at all.

-- I'll also add the following annotation:  This program is written for a very specific reactor using
-- 8 awakened blocks of fuel.  I haven't tested any other config.  I also expect that the primary energy core
-- hard wired (connected with cryo ducts) to the reactor will typically be between 50 and 75% full, with
-- a second T7 that can have energy shunted to it.  I then swap the core out of the secondary T7 energy
-- core using either blood magic teleposers or thaum wand of dislocation
-- note do not put the full core in the same cube as the T7 core or it will detect it and be 'invalid'

--Rev 20210625 wtp 1.2
-- moved to dirtcraft
--Rev. 20210619 wtp
--As my previous paste could be my 'first', this one will become my 1.1 release.

--Developed for use on 1.7 Infinity with Draconic Evolution 1.7.10-1.0.2h (Mym.li normal mode)

--I've got the main parts I wanted, the setup and considerations are detailed below:

--Advanced computer with a Draconic Reactor stabilizer on it's right side.
--Red cage lamp on top (to come on when either containment field or saturation <51%)
-- Note: neither light will light nor flash at 51%, if the last iteration left the red light illuminated it will stay
--       illuminated until either it drops below 51% or rises up or beyond 52% (I call this the 'transition period')
--Green cage lamb on back (to come on with both containment field and saturation >51%)
--A wired modem is on the left side with a cable running up to the Tier-7 Draconic Energy Core Energy Pylon
--advanced monitors 5 wide, three tall stacked below the computer facing the stabilizer I have the flux gate on.
--The Draconic Reactor is connected directly with cryotheum ducts from the stabilizer to the T7 energy 'input'
--then the T7 energy output goes to the reactor injector.
-- The reactor injector flux gate has a redstone signal high at 262,000RF/t and connects back to the injector in
-- reverse containment field mode (three repeaters and a piece of redstone) using 139,700K for my mostly used reactor
-- The stabilizer flux gate to the T7 energy core is currently set at 2,010,000 though of course that took weeks and starts
-- out much lower.
-- Since the T7 fills up and the reactor essentially shuts down, I have a third flux gate 'drain' between the T7
-- energy core and the injector flux gate which is also connected to a modem and wired back to the computer.
-- The idea is to allow both my use and public use to draw on the reactor up to the amount the reactor creates,
-- but to limit the flux gate if that drain gets too high as I've found connecting a new t7 to any of those tessearcts
-- on that flux gate would run out the buffer for the reactor and it would ultimately fail (I lost at least one core this way)

-- Its worth acknowledging that the mym.li servers disable the explosion, so while losing the chaos shards hurts,
-- at least you don't lose the rest of the infrastructure.

-- Changes for the 19th.
-- Mostly cosmetic, I'm going to start by converting my print redirect output to specific monitor coordinates
-- also better color management, so if the saturation is gaining during the transition period I want that green
-- but the draining warning should be yellow
-- the fluxgate flow override when it kicks in should be red
-- the normal flux gate flow set to the generation power-field drain should be green
-- I may also suppress the maxFieldStrength and maxEnergySaturation as it's static and you sort of get that from the
-- current values and their respective percentages
-- I'm also going to shuffle around and try to put the variable definitions together in a block rather than
-- having code intermixed in the variable initialization block

-- rev 1.2 import borrowed functions
-- ============================== --
  -- functions (borrowed from knPtJCjb)