Many changes in instrument and validation

Erwan Motte
1 parent 14a564f7
Showing 12 changed files with 272 additions and 4 deletions Show diff stats
.idea/codeStyleSettings.xml
.idea/dictionaries/motte.xml
source/ANA/ANA_colocate.rst
source/ANA/ANA_index.rst
source/INS/INS_antennas.rst
source/INS/INS_calib.rst
source/INS/INS_data_format.rst
source/INS/INS_evolutions.rst
source/INS/INS_index.rst
source/VAL/VAL_index.rst
source/VAL/VAL_ins_antennas.rst
source/VAL/VAL_ins_frontend.rst
@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="ProjectCodeStyleSettingsManager">
+    <option name="PER_PROJECT_SETTINGS">
+      <value />
+    </option>
+    <option name="PREFERRED_PROJECT_CODE_STYLE" value="Default (1)" />
+  </component>
+</project>
 \ No newline at end of file
@@ -0,0 +1,3 @@
+<component name="ProjectDictionaryState">
+  <dictionary name="motte" />
+</component>
 \ No newline at end of file
@@ -0,0 +1,49 @@
+***********
+Co-location
+***********
+
+Read L1b and filter
+===================
+Purpose
+-------
+
+input
+-----
+
+output
+------
+
+
+Read Shapefile and convert
+==========================
+Purpose
+-------
+This set of routines reads the description of the fields from GIS software
+made in the Shapefile format, and extract the information of interest.
+
+input
+-----
+
+Shapefile in the `esri shapefile`_ format, with area defined by polygons and
+coordinates in the Lambert-93 projection.
+
+.. _`esri shapefile`: https://en.wikipedia.org/wiki/Shapefile
+
+output
+------
+GeoPandas Dataframe in Lambert-93 projection
+
+
+
+Perform the co-location
+=======================
+Purpose
+-------
+
+input
+-----
+
+output
+------
+
+
@@ -2,3 +2,7 @@
 Data Analysis
 ********************
  
+.. toctree::
+   :maxdepth: 2
+
+   ANA_colocate
 ***************
 Antennas
 ***************
+
+GLORI is based on a dual antenna setup:
+
+- one uplooking aka Zenith Antenna
+- one downlooking aka Nadir Antenna
+
+The zenith antenna is Right Hand Cicular Polarized, the Nadir antenna has dual polarization capabilities
+
+- one output for Left Hand Cicular Polarization (LHCP)
+- one output for Right Hand Cicular Polarization (LHCP)
+
+If active antennas are used, power has to be provided through a bias tee.
+
+
+GLORIE 2015 version
+===================
+
+Zenith Antenna
+--------------
+
+- The zenith Antenna is a :ref:`Antcom_42G1215RL` in the same configuration
+  as in the `KuROS 2014 version`_
+
+
+Nadir Antenna
+-------------
+
+- The Nadir antenna was changed for a :ref:`Cobham_DS1563`.
+- It is linked to the :ref:`INS_calib` by 50 cm low loss coaxial cables.
+- Low Noise amplification is now performed by discrete components
+  within the :ref:`INS_calib`.
+
+
+KuROS 2014 version
+==================
+
+Zenith Antenna
+--------------
+
+- The zenith Antenna is a :ref:`Antcom_42G1215RL`.
+- It is powered by a bias tee placed directly on the antenna.
+- Low loss 10-meter cables are used.
+- Only the RHCP port is used.
+- A 50 Ohm Load is plugged to the LHCP port.
+
+
+Nadir Antenna
+-------------
+
+- The Nadir Antenna is also a :ref:`Antcom_42G1215RL`.
+- It is powered by a bias tee placed in the Front end.
+- Because of current draw by the filters, one more bias tees is used, on the
+  other polarization channel.
+- Low loss 10-meter cables are used.
+
+
+Antennas Description
+====================
+
+.. _Antcom_42G1215RL:
+
+Antcom L1/L2 dual pol hemispherical active antenna
+--------------------------------------------------
+
+Specification
+.............
+
+- L1 and L2 GPS frequency
+- Beamwidth: 140 deg
+- LNA: 33dB (NF = 3dB)
+- Power: 2.5-24V (<50mA)
+- Axial ratio: 2 dB
+- 55 to +85 deg C
+
+Documents
+.........
+
+- Datasheet (:download:`pdf </downloads/technical/Antcom_42G1215RL-AA-XT-1_L1L2GPS.pdf>`).
+
+.. todo::
+   insert Measured Radiation pattern: LHCP and RHCP Co and xPol (CNES)
+
+.. _Cobham_DS1563:
+
+Cobham L1 dual pol hemispherical passive antenna
+------------------------------------------------
+
+Specification
+.............
+
+- GPS L1 frequency only
+- Beamwidth: 90 deg
+- Passive
+- Axial ratio: 1 dB
+- 55 to +85 deg C
+- passive
+
+
+Documents
+
+- Datasheet (:download:`pdf </downloads/technical/Cobham_DS1563.pdf>`).
+- CAD file in step format
+  (:download:`zip </downloads/technical/Cobham_DS1563.zip>`).
+
+.. todo::
+   insert Measured Radiation pattern: LHCP and RHCP Co and xPol (CNES)
 \ No newline at end of file
+.. _INS_calib:
+
 ******************
 Calibration Module
 ******************
+
+Goal
+====
+
+The goal of the calibration module is to be able to perform a relative
+calibration of both reflected polarization and also relative calibration of
+reflected channels vs. direct channel. For this purpose, it includes a set
+of transfer switches allowing to send any input RF signal on any of the
+Front end inputs.
+
+The calibration module was originally part of the front end in the KuROS
+2014 version. With the use of passive antennas, it was moved next to the
+antenna in order to be able to calibrate the whole cable and amplifiers and
+to minimize the losses.
+
+Description
+===========
+
+
+
+.. figure:: /img/INS_calib.png
+   :align: center
+   :alt:
+
+   Calibration Module (made with lucid charts)
+
+
+Components
+==========
+
+The following components are used within the calibration chain in order to
+provide 
+
+
 ***************
-Intro
+Raw Data format
 ***************
@@ -0,0 +1,9 @@
+**********************
+Instrument Evolutions
+**********************
+
+
+
+
+Suggestions / Bug Tracking
+==========================
@@ -4,8 +4,6 @@
 The Glori Instrument
 ********************
  
-
-
 .. toctree::
    :maxdepth: 2
  
@@ -15,4 +13,5 @@ The Glori Instrument
    INS_frontend
    INS_backend
    INS_ancillary
-   INS_data_format
 \ No newline at end of file
+   INS_data_format
+   INS_evolutions
 \ No newline at end of file
+.. _Validation:
+
 ********************
 Validation
 ********************
  
+.. toctree::
+   :maxdepth: 2
+
+   VAL_ins_antennas
+   VAL_ins_frontend
 \ No newline at end of file
@@ -0,0 +1,19 @@
+
+
+*********************
+Antennas Validation
+*********************
+
+
+Radiation patterns
+=====================
+
+
+
+
+
+Suggestions / Improvements
+==========================
+
+
+
@@ -0,0 +1,27 @@
+
+
+*********************
+Front end Validation
+*********************
+
+
+Oscillator stability
+=====================
+
+Oscillator frequency
+====================
+
+
+Channel to channel phase stability
+==================================
+
+
+Data transmission
+=================
+
+
+Suggestions / Improvements
+==========================
+
+
+
...	...	@@ -0,0 +1,9 @@
	1	+<?xml version="1.0" encoding="UTF-8"?>
	2	+<project version="4">
	3	+ <component name="ProjectCodeStyleSettingsManager">
	4	+ <option name="PER_PROJECT_SETTINGS">
	5	+ <value />
	6	+ </option>
	7	+ <option name="PREFERRED_PROJECT_CODE_STYLE" value="Default (1)" />
	8	+ </component>
	9	+</project>
0	10	\ No newline at end of file
...	...
...	...	@@ -0,0 +1,3 @@
	1	+<component name="ProjectDictionaryState">
	2	+ <dictionary name="motte" />
	3	+</component>
0	4	\ No newline at end of file
...	...
...	...	@@ -0,0 +1,49 @@
	1	+***********
	2	+Co-location
	3	+***********
	4	+
	5	+Read L1b and filter
	6	+===================
	7	+Purpose
	8	+-------
	9	+
	10	+input
	11	+-----
	12	+
	13	+output
	14	+------
	15	+
	16	+
	17	+Read Shapefile and convert
	18	+==========================
	19	+Purpose
	20	+-------
	21	+This set of routines reads the description of the fields from GIS software
	22	+made in the Shapefile format, and extract the information of interest.
	23	+
	24	+input
	25	+-----
	26	+
	27	+Shapefile in the `esri shapefile`_ format, with area defined by polygons and
	28	+coordinates in the Lambert-93 projection.
	29	+
	30	+.. _`esri shapefile`: https://en.wikipedia.org/wiki/Shapefile
	31	+
	32	+output
	33	+------
	34	+GeoPandas Dataframe in Lambert-93 projection
	35	+
	36	+
	37	+
	38	+Perform the co-location
	39	+=======================
	40	+Purpose
	41	+-------
	42	+
	43	+input
	44	+-----
	45	+
	46	+output
	47	+------
	48	+
	49	+
...	...
...	...	@@ -2,3 +2,7 @@
2	2	Data Analysis
3	3	********************
4	4
	5	+.. toctree::
	6	+ :maxdepth: 2
	7	+
	8	+ ANA_colocate
...	...
1	1	***************
2	2	Antennas
3	3	***************
	4	+
	5	+GLORI is based on a dual antenna setup:
	6	+
	7	+- one uplooking aka Zenith Antenna
	8	+- one downlooking aka Nadir Antenna
	9	+
	10	+The zenith antenna is Right Hand Cicular Polarized, the Nadir antenna has dual polarization capabilities
	11	+
	12	+- one output for Left Hand Cicular Polarization (LHCP)
	13	+- one output for Right Hand Cicular Polarization (LHCP)
	14	+
	15	+If active antennas are used, power has to be provided through a bias tee.
	16	+
	17	+
	18	+GLORIE 2015 version
	19	+===================
	20	+
	21	+Zenith Antenna
	22	+--------------
	23	+
	24	+- The zenith Antenna is a :ref:`Antcom_42G1215RL` in the same configuration
	25	+ as in the `KuROS 2014 version`_
	26	+
	27	+
	28	+Nadir Antenna
	29	+-------------
	30	+
	31	+- The Nadir antenna was changed for a :ref:`Cobham_DS1563`.
	32	+- It is linked to the :ref:`INS_calib` by 50 cm low loss coaxial cables.
	33	+- Low Noise amplification is now performed by discrete components
	34	+ within the :ref:`INS_calib`.
	35	+
	36	+
	37	+KuROS 2014 version
	38	+==================
	39	+
	40	+Zenith Antenna
	41	+--------------
	42	+
	43	+- The zenith Antenna is a :ref:`Antcom_42G1215RL`.
	44	+- It is powered by a bias tee placed directly on the antenna.
	45	+- Low loss 10-meter cables are used.
	46	+- Only the RHCP port is used.
	47	+- A 50 Ohm Load is plugged to the LHCP port.
	48	+
	49	+
	50	+Nadir Antenna
	51	+-------------
	52	+
	53	+- The Nadir Antenna is also a :ref:`Antcom_42G1215RL`.
	54	+- It is powered by a bias tee placed in the Front end.
	55	+- Because of current draw by the filters, one more bias tees is used, on the
	56	+ other polarization channel.
	57	+- Low loss 10-meter cables are used.
	58	+
	59	+
	60	+Antennas Description
	61	+====================
	62	+
	63	+.. _Antcom_42G1215RL:
	64	+
	65	+Antcom L1/L2 dual pol hemispherical active antenna
	66	+--------------------------------------------------
	67	+
	68	+Specification
	69	+.............
	70	+
	71	+- L1 and L2 GPS frequency
	72	+- Beamwidth: 140 deg
	73	+- LNA: 33dB (NF = 3dB)
	74	+- Power: 2.5-24V (<50mA)
	75	+- Axial ratio: 2 dB
	76	+- 55 to +85 deg C
	77	+
	78	+Documents
	79	+.........
	80	+
	81	+- Datasheet (:download:`pdf </downloads/technical/Antcom_42G1215RL-AA-XT-1_L1L2GPS.pdf>`).
	82	+
	83	+.. todo::
	84	+ insert Measured Radiation pattern: LHCP and RHCP Co and xPol (CNES)
	85	+
	86	+.. _Cobham_DS1563:
	87	+
	88	+Cobham L1 dual pol hemispherical passive antenna
	89	+------------------------------------------------
	90	+
	91	+Specification
	92	+.............
	93	+
	94	+- GPS L1 frequency only
	95	+- Beamwidth: 90 deg
	96	+- Passive
	97	+- Axial ratio: 1 dB
	98	+- 55 to +85 deg C
	99	+- passive
	100	+
	101	+
	102	+Documents
	103	+
	104	+- Datasheet (:download:`pdf </downloads/technical/Cobham_DS1563.pdf>`).
	105	+- CAD file in step format
	106	+ (:download:`zip </downloads/technical/Cobham_DS1563.zip>`).
	107	+
	108	+.. todo::
	109	+ insert Measured Radiation pattern: LHCP and RHCP Co and xPol (CNES)
4	110	\ No newline at end of file
...	...
	1	+.. _INS_calib:
	2	+
1	3	******************
2	4	Calibration Module
3	5	******************
	6	+
	7	+Goal
	8	+====
	9	+
	10	+The goal of the calibration module is to be able to perform a relative
	11	+calibration of both reflected polarization and also relative calibration of
	12	+reflected channels vs. direct channel. For this purpose, it includes a set
	13	+of transfer switches allowing to send any input RF signal on any of the
	14	+Front end inputs.
	15	+
	16	+The calibration module was originally part of the front end in the KuROS
	17	+2014 version. With the use of passive antennas, it was moved next to the
	18	+antenna in order to be able to calibrate the whole cable and amplifiers and
	19	+to minimize the losses.
	20	+
	21	+Description
	22	+===========
	23	+
	24	+
	25	+
	26	+.. figure:: /img/INS_calib.png
	27	+ :align: center
	28	+ :alt:
	29	+
	30	+ Calibration Module (made with lucid charts)
	31	+
	32	+
	33	+Components
	34	+==========
	35	+
	36	+The following components are used within the calibration chain in order to
	37	+provide
	38	+
	39	+
...	...
1	1	***************
2		-Intro
	2	+Raw Data format
3	3	***************
...	...
...	...	@@ -0,0 +1,9 @@
	1	+**********************
	2	+Instrument Evolutions
	3	+**********************
	4	+
	5	+
	6	+
	7	+
	8	+Suggestions / Bug Tracking
	9	+==========================
...	...
...	...	@@ -4,8 +4,6 @@
4	4	The Glori Instrument
5	5	********************
6	6
7		-
8		-
9	7	.. toctree::
10	8	:maxdepth: 2
11	9
...	...	@@ -15,4 +13,5 @@ The Glori Instrument
15	13	INS_frontend
16	14	INS_backend
17	15	INS_ancillary
18		- INS_data_format
19	16	\ No newline at end of file
	17	+ INS_data_format
	18	+ INS_evolutions
20	19	\ No newline at end of file
...	...
	1	+.. _Validation:
	2	+
1	3	********************
2	4	Validation
3	5	********************
4	6
	7	+.. toctree::
	8	+ :maxdepth: 2
	9	+
	10	+ VAL_ins_antennas
	11	+ VAL_ins_frontend
5	12	\ No newline at end of file
...	...