AISystems

[Arunesh-Gour]

Input variables

From sensors

• TAN (Total Ammonia Nitrogen).
• Temperature.
• pH.
• DO (Dissolved Oxygen).
• NO2 (nitrite).
• NO3 (nitrate).
• WaterLevel (percent of tank, level).

Calculate

• Unionized NH3 (ammonia).
• Condition {safe, danger, toxic}.
• CaOH / KOH amount for tank.
• Chealated iron (2mg / liter).

Safe ranges

All values are in ppm, except for Temperature, whose values are in deg celsius and WaterLevel, which are in percentage.

• TAN (Total Ammonia Nitrogen): {safe:(< 1.0), danger:(> 1.0), toxic:(when (Temperature or pH or both) is in danger or toxic)}.
• Temperature: {safe:(27.0-29.0), danger:(18.0-27.0, 29.0-32.0), toxic:(< 18.0, > 32.0)}.
• pH: {safe:(6.8-7.0), danger:(6.4-6.8, 7.0-7.4), toxic:(< 6.4, > 7.4)}.
• DO (Dissolved Oxygen): {safe:(> 6.5), danger:(4.5-6.5), toxic:(< 4.5)}.
• NO2 (nitrite): {safe:(0.5-1.0), danger:(0.1-0.5), toxic:(< 0.1, > 1.0)}.
• NO3 (nitrate): {safe:(10.0-100.0), danger:(5.0-10.0, 100.0-450.0), toxic:(< 5.0, > 450.0)}.
• WaterLevel: {safe:(70.0-80.0), danger:(50.0-70.0, 80.0-85.0), toxic:(< 50.0, > 85.0)} % of tank height.
• UnionizedNH3: {safe:(0.0-0.3), danger:(0.3-0.5), toxic:(> 0.5)}.

Impact

• Condition -> change TAN / ph / Temperature / water -> fail=alert.
• TAN (Total Ammonia Nitrogen) -> change pH / Temperature / water -> fail=alert.
• pH -> add (CaOH / KOH) / show alert -> fail=alert.
• Temperature -> turn on / off water heater -> fail=alert.
• DO (Dissolved Oxygen) -> change water -> fail=alert.
• NO2 (nitrite) -> change water -> fail=alert.
• NO3 (nitrate) -> change water -> fail=alert.
• WaterLevel -> add / remove water -> fail=alert.
• Give alerts every 3 week to add Chelated Iron -> fail=alert.

[Arunesh-Gour]

Calculating unionized NH3

• Measure TAN, temperature and pH.
• Find multiplication factor from Table 1_, using closest temperature and pH.
• unionizedNH3 = TAN * multiplication factor.
• Condition will be calculated using Table 2_ and/or from safe range given in above post.

Table 1

Table 2

[Arunesh-Gour]

AISystems

:File: AISystems/AISystem.py.

Implement logic in following functions only:

• _check_safetyLevels.
• _change_pH.
• _change_water.
• _change_waterlevel.
• _check_unionizedAmmonia.
• _check_TAN.
• _check_pH.
• _check_temperature.
• _check_DO.
• _check_nitrite.
• _check_nitrate.
• _check_waterLevel.

Instructions

• Implement logic only.
• Functions can be called only from _check_safetyLevels and _change_* functions.
• _check_safetyLevels will call _check_* functions to check all values, which will be
  stored as safe or unsafe in _dataAttributes['safetyLevels'][attribute].
• For logic implement using above safety level variables as if ((safetyLevel.attribute1 & 2) == unsafe) {do task1} elif ....
• Do not touch other functions.
• If there is a need to create a function, name it by appending an underscore (_) in front of its name.
• For _change_* function, which are acquiring locks, put all logic between the critical section only.
• Flow of program and other connections will be managed later by @Arunesh-Gour (me) according to Core files.
• For generating alerts, wherever the system fails, do use alert system which is demonstrated in comments in the file.
• Alerts are not just for display purpose, they also trigger an emergency response system. So, make sure you raise alerts as well.
• Emergency response system will be worked upon separately.
• We're not controlling water temperature as it will be automatically managed by the automatic heater. We just monitor it to raise alert.
• Use time.sleep(float seconds) and re-check values right in change_* functions to make sure the system completes the process
  in the same function.
• _check_safetyLevels call one function and waits for it to complete before proceeding.
• While programming, use 3 spaces instead of tabs. .vimrc file is given in config to be used with your text editors,
  especially for VI and VIM.