[EVA-2020-02.git] / README.org

* Environment Sensor ninfacyzga-01
** Introduction
This document created by Steven Baltakatei Sandoval on
2020-06-07T21:56Z under a [[http://creativecommons.org/licenses/by-sa/4.0/][CC BY-SA 4.0]] license and last updated on
2020-07-23T22:26Z.
** Abstract
This git repository contains software and documentation necessary to
set up a sensor package for logging observables in the local
environment.

Collected sensor data include:

- Location (GPS WGS84)
- Time (via ~gpsd~)
- Air Pressure (pascals)
- Alignment (degrees X, degrees Y, degrees from magnetic north)

** Setup

See the following documents for instructions on setting up hardware
for each type of data collected.

*** Location

See the location [[file:doc/location/README.org][readme]].

*** Pressure

See the pressure [[file:doc/pressure/README.org][readme]].

*** Alignment

See the alignment [[file:doc/alignment/README.org][readme]].

** Name Etymology

*** Origin

The name ~ninfacyzga~ is a [[https://mw.lojban.org/papri/Logical_Language_Group][lojban]] [[https://mw.lojban.org/papri/lujvo][lujvo]] consisting of the tanru "cnino
fatci zgana". The three gismu in the tanru contain the following
meanings:

**** ~cnino~: new
**** ~fatci~: fact
**** ~zgana~: observe

*** Meaning

Hence, the primary mission of a ~ninfacyzga~ device is to observe facts
of the new. The primary mission is NOT to process facts into
stories. Neither is the primary mission to network with other devices
for the purpose of sharing information. This means a ~ninfacyzga~
device records data about the environment but does not attempt to
generate summaries or reports of archived data as a historian
would. Instead, the device simply transmits what it sees (ex: camera),
hears (ex: microphone), feels (ex: accelerometer, gyroscope, or
magnetometer), smells (ex: gas detector), etc.

The observations of a ~nincafyzga~ device are the input of another
class of devices called ~temlisru'e~ whose primary mission is to
process observations into stories over time.

The transmission and verification of observations and analyses
produced by ~ninfacyzga~ or ~temlisru'e~ devices is managed by another
class of devices called ~calkuptcana~.

*** Pronunciation

~ninfacyzga~ is pronounced ~/ninfaʃəzga/~.

~temlisru'e~ is pronounced ~/tɛmlisruhe/~.

~calkuptcana~ is pronounced ~/ʃalkuptʃana/~.

** Directory structure

Directories in this repository are structured as follows:

- ~doc~: Contains documentation explaining in human-readable format
  what each file does.

- ~archive~: Contains legacy files from previous iterations of the
  project.
  
- ~exec~: Contains executable components of the project.

** References

1. "Lojban". 2020-02-12. [[https://mw.lojban.org/papri/Logical_Language_Group]["Logical Language Group"]]. Date Accessed:
   2020-06-07. [[https://web.archive.org/web/20200304102316/https://mw.lojban.org/papri/Logical_Language_Group][Archive link]]. Archive date: 2020-03-04.

2. "lujvo". 2014-09-30. [[https://mw.lojban.org/papri/Logical_Language_Group]["Logical Language Group"]]. Date Accessed:
   2020-06-07. [[https://web.archive.org/web/20160401100124/https://mw.lojban.org/papri/lujvo][Archive link]]. Archive date: 2016-04-01.
Commit	Line	Data
1ce28642 SBS	1	* Environment Sensor ninfacyzga-01
	2	** Introduction
	3	This document created by Steven Baltakatei Sandoval on
	4	2020-06-07T21:56Z under a [[http://creativecommons.org/licenses/by-sa/4.0/][CC BY-SA 4.0]] license and last updated on
6bdc2473	5	2020-07-23T22:26Z.
1ce28642 SBS	6	** Abstract
	7	This git repository contains software and documentation necessary to
	8	set up a sensor package for logging observables in the local
	9	environment.
	10
	11	Collected sensor data include:
	12
	13	- Location (GPS WGS84)
6bdc2473	14	- Time (via ~gpsd~)
1ce28642 SBS	15	- Air Pressure (pascals)
	16	- Alignment (degrees X, degrees Y, degrees from magnetic north)
	17
	18	** Setup
	19
	20	See the following documents for instructions on setting up hardware
	21	for each type of data collected.
	22
	23	*** Location
	24
	25	See the location [[file:doc/location/README.org][readme]].
	26
	27	*** Pressure
	28
	29	See the pressure [[file:doc/pressure/README.org][readme]].
	30
	31	*** Alignment
	32
	33	See the alignment [[file:doc/alignment/README.org][readme]].
	34
	35	** Name Etymology
	36
	37	*** Origin
	38
	39	The name ~ninfacyzga~ is a [[https://mw.lojban.org/papri/Logical_Language_Group][lojban]] [[https://mw.lojban.org/papri/lujvo][lujvo]] consisting of the tanru "cnino
	40	fatci zgana". The three gismu in the tanru contain the following
	41	meanings:
	42
	43	**** ~cnino~: new
	44	**** ~fatci~: fact
	45	**** ~zgana~: observe
	46
	47	*** Meaning
	48
	49	Hence, the primary mission of a ~ninfacyzga~ device is to observe facts
	50	of the new. The primary mission is NOT to process facts into
	51	stories. Neither is the primary mission to network with other devices
	52	for the purpose of sharing information. This means a ~ninfacyzga~
	53	device records data about the environment but does not attempt to
	54	generate summaries or reports of archived data as a historian
	55	would. Instead, the device simply transmits what it sees (ex: camera),
	56	hears (ex: microphone), feels (ex: accelerometer, gyroscope, or
	57	magnetometer), smells (ex: gas detector), etc.
	58
	59	The observations of a ~nincafyzga~ device are the input of another
	60	class of devices called ~temlisru'e~ whose primary mission is to
	61	process observations into stories over time.
	62
	63	The transmission and verification of observations and analyses
	64	produced by ~ninfacyzga~ or ~temlisru'e~ devices is managed by another
	65	class of devices called ~calkuptcana~.
	66
	67	*** Pronunciation
	68
	69	~ninfacyzga~ is pronounced ~/ninfaʃəzga/~.
	70
	71	~temlisru'e~ is pronounced ~/tɛmlisruhe/~.
	72
	73	~calkuptcana~ is pronounced ~/ʃalkuptʃana/~.
	74
	75	** Directory structure
	76
	77	Directories in this repository are structured as follows:
	78
79	- ~doc~: Contains documentation explaining in human-readable format
80	what each file does.
81
82	- ~archive~: Contains legacy files from previous iterations of the
83	project.
84
85	- ~exec~: Contains executable components of the project.
86
87	** References
88
89	1. "Lojban". 2020-02-12. [[https://mw.lojban.org/papri/Logical_Language_Group]["Logical Language Group"]]. Date Accessed:
90	2020-06-07. [[https://web.archive.org/web/20200304102316/https://mw.lojban.org/papri/Logical_Language_Group][Archive link]]. Archive date: 2020-03-04.
91
92	2. "lujvo". 2014-09-30. [[https://mw.lojban.org/papri/Logical_Language_Group]["Logical Language Group"]]. Date Accessed:
93	2020-06-07. [[https://web.archive.org/web/20160401100124/https://mw.lojban.org/papri/lujvo][Archive link]]. Archive date: 2016-04-01.