Skip to content
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -58,7 +58,7 @@ Match (colocalize) Datasets
End depth [m]. This parameter sets the upper bound of the vertical cut. Note depth is a positive number (it is 0 at the surface and increases towards the ocean floor).

**temporalTolerance: list of int**
Temporal tolerance values between pairs of source and target datasets. The size and order of values in this list should match those of targetTables. If only a single integer value is given, that would be applied to all target datasets. This parameter is in days except when the target variable represents monthly climatology data in which case it is in months. Notice fractional values are not supported in the current version.
Temporal tolerance values between pairs of source and target datasets. The size and order of values in this list should match those of targetTables. If only a single integer value is given, that would be applied to all target datasets. This parameter is in days except when the target variable represents monthly climatology data in which case it is in months. Note fractional values are not supported in the current version.
**latTolerance: list of float or int**
Spatial tolerance values in meridional direction [deg] between pairs of source and target datasets. The size and order of values in this list should match those of targetTables. If only a single float value is given, that would be applied to all target datasets. A "safe" value for this parameter can be slightly larger than the half of the target variable's spatial resolution.
**lonTolerance: list of float or int**
Expand All @@ -72,43 +72,43 @@ Match (colocalize) Datasets
|


Example 1:
Example 1
----------

In this example, the abundance of a prochlorococcus strain (MIT9313PCR, see lines 5-6) measured by Chisholm lab during the AMT13 cruise (Atlantic Meridional Transect Cruise 13) is colocalized with 3 target variables (lines 7-8):
The abundance of a prochlorococcus strain (MIT9313PCR, see lines 5-6) measured by Chisholm lab during the AMT13 cruise (Atlantic Meridional Transect Cruise 13) is colocalized with 3 target variables (lines 7-8):

- 'MIT9312PCR_Chisholm' from the same source dataset
- 'phosphate*WOA*\ clim' from World Ocean Atlas monthly climatology dataset
- 'chl' (chlorophyll) from weekly averaged satellite dataset

|

**Tip1:**
**Tip1**

The space-time cut parameters (lines 9-16) have been set in such a way to encompass the entire source dataset 'tblAMT13_Chisholm' (see the dataset page for more details). Note that the last data point at the source dataset has been measured at '2003-10-12 12:44:00'. For simplicity dt2 has been set to '2003-10-13', but you could also use the exact date-time '2003-10-12 12:44:00'.

**Tip2:**
**Tip2**

AMT13 cruise trajectory is already in Simons CMAP database. Therefore, another way to find reasonable values for the space-time cut parameters (lines 9-16) is to use the outputs of the following command:
api.cruise_bounds('AMT13').

**Tip3:**
**Tip3**

The temporalTolerance parameter is set to [0, 0, 1] (line 17). This means:

- ±0 day temporal tolerance when matching with 'MIT9312PCR_Chisholm' (exact date-time matching)
- ±0 month temporal tolerance when matching with 'phosphate*WOA*\ clim' (this is a monthly climatology dataset)
- ±4 day temporal tolerance when matching with 'chl' (this is a weekly averaged dataset)

**Tip4:**
**Tip4**

The latTolerance and lonTolerance parameters are set to [0, 0.5, 0.25] (lines 18-19). This means:

- ±0 day temporal tolerance when matching with 'MIT9312PCR_Chisholm' (exact date-time matching)
- ±0 month temporal tolerance when matching with 'phosphate*WOA*\ clim' (this is a monthly climatology dataset)
- ±4 day temporal tolerance when matching with 'chl' (this is a weekly averaged dataset)

**Tip5:**
**Tip5**

The depthTolerance parameter is set to [0, 5, 0] (line 20). This means:

Expand Down Expand Up @@ -146,23 +146,23 @@ The depthTolerance parameter is set to [0, 5, 0] (line 20). This means:



Example 2:
Example 2
----------

The source variable in this example is particulate pseudo cobalamin ('Me_PseudoCobalamin_Particulate_pM' see lines 5-6) measured by Ingalls lab during the KM1315 cruise. This variable is colocalized with one target variabele, 'picoprokaryote' concentration, from Darwin model (lines 7-8). The colocalized data, then is visualized. please review the above Example 1, since the mentioned tips apply to this example too.
The source variable is particulate pseudo cobalamin ('Me_PseudoCobalamin_Particulate_pM' see lines 5-6) measured by Ingalls lab during the KM1314 cruise. This variable is colocalized with one target variabele, 'picoprokaryote' concentration, from Darwin model (lines 7-8). The colocalized data is visualized (lines 26-29). Please review Example 1, since the mentioned tips apply to this example too.

|

**Tip1:**
**Tip1**

The employed Darwin model outputs are a 3-day averaged dataset, and therefore ±2 day temporal tolerance is used (line 17).

**Tip2:**
**Tip2**

The employed Darwin model outputs have has a 0.5 degree spatial resolution in zonal and meridional directions, and so ±0.25 degree spatial tolerance is used (line 18-19).


**Tip3:**
**Tip3**

Darwin model first depth level is at 5 m (not 0), and so ±5 meter vertical tolerance should cover all surface measurements (line 20).

Expand Down Expand Up @@ -229,7 +229,9 @@ Here is how to achieve the same results using a direct SQL statement. Please ref
'lonTolerance',
'depthTolerance'

**Example:**
**Example**

The source variable is particulate pseudo cobalamin ('Me_PseudoCobalamin_Particulate_pM') measured by Ingalls lab during the KM1314 cruise. This variable is colocalized with one target variabele, 'picoprokaryote' concentration, from Darwin model.

.. code-block:: sql

Expand Down