comments and remarks

src/main/resources/modules/menstrual_cycle.json

@@ -1,13 +1,17 @@
 {
-  "name": "Wearables_Sleep",
+  "name": "Menstrual Cycle",
   "remarks": [ 
+    "The reproductive system of a female, unlike men, shows regular cyclic changes that teleologically may be regarded as periodic preparation for pregnancy and fertilization. In primates and humans, the cycle is a menstrual cycle, and its most conspicuous feature is the periodic vaginal bleeding that occurs with the shedding of uterine mucose (menstruation). The length of the cycle is notoriously variable, but an average figure is 28 days from the start of one menstrual period to the start of the next. By common usage, the days of the cycle are identified by number starting with the first day of menstruation. It begins at puberty, ranging from the ages of 10 to 16, and ends at menopause at an average age of 51.  -Thiyagarajan, Basit, Jeanmonod 2022",
     "",
     "References",
-    "",
+    "https://www.ncbi.nlm.nih.gov/books/NBK500020/",
+    "Roblitz2013_Menstrual_Cycle.pdf", 
     "", 
     "Known model limitations:",
-    "",
-    ""
+    "This model is significantly more complex than other models included in Synthea, with nearly 10x more parameters than the circadian cycle.",
+    "Currently, only Estradiol output levels are mapped to output data.",
+    "This model generates continuous data over a 28 cycle, which would not be recorded in any known clinical test.  Rather, laboratory tests would typically involve a blood draw, and a discrite value at a single point in time.",
+    "Details for writing intersection functions to extract a single value are explianed in greater detail in the Synthea Wiki."
    ],
   "states": {
     "Initial": {

src/main/resources/modules/wearables_circadian.json

@@ -1,13 +1,15 @@
 {
   "name": "Wearables_Circadian",
   "remarks": [
-    "",
+    "The regulation of sleep is processed by the homeostatic physiology of the circadian rhythm, the sleep/wake cycle. Circadian rhythm is the 24-hour internal clock in our brain that regulates cycles of alertness and sleepiness by responding to light changes in our environment. ",
+    "", 
     "References",
-    "",
+    "https://www.ncbi.nlm.nih.gov/books/NBK519507/",
     "", 
     "Known model limitations:",
-    "",
-    ""
+    "This model produces continuous data over 24hrs, and would not typically be reportable in any sort of laboratory test.  Clinical tests of melatonin or cortisol would take discrete sample at a specific time.",
+    "This model can be interected with another function (i.e. a line), to produce a sleep/wake cycle.  Additional information on how to do this is provided in the Wiki.",
+    "This model me be useful in generating cyclical daily habits, such as taking medicaitons in the morning, exercising at certain times of the day, and so forth.  Please see the Wiki for additional details." 
   ],
   "states": {
     "Initial": {

src/main/resources/modules/wearables_o2.json

@@ -1,12 +1,13 @@
 {
   "name": "Wearables_O2_Stats",
   "remarks": [
+    "According to the American Medical Association, it is believed that more than 30 million people have sleep apnea in the US, about 9% of the population.  Manufacturers estimate that approximately 8 million sleep with a CPAP machine each night.",
     "",
     "References",
-    "",
+    "https://www.cpap.com/blog/sleep-apnea-statistics/",
     "", 
     "Known model limitations:",
-    "",
+    "Physiology model reports arterial oxygnation (PO2ART) over a 60 second (1 min) interval.  Wearable devices that monitor sleep typically provide summary statistics, such as '5hrs 30min of sleep last night'.  Physiology model may need to be sampled multiple times for a sleep study observation.    ",
     ""
   ],
   "states": {