Skip to content

Commit b7fc796

Browse files
committed
rm splits
1 parent b5c81e3 commit b7fc796

File tree

26 files changed

+108
-1365
lines changed

26 files changed

+108
-1365
lines changed

Dockerfile

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -43,7 +43,6 @@ COPY --chown=docker:docker . .
4343

4444
# Build, install, check FORCE
4545
RUN echo "building FORCE" && \
46-
./splits.sh enable && \
4746
./debug.sh $debug && \
4847
sed -i "/^INSTALLDIR=/INSTALLDIR=$INSTALL_DIR/" Makefile && \
4948
make -j && \

Makefile

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -243,7 +243,7 @@ misc:
243243
### dummy code for testing stuff
244244

245245
#dummy: temp cross aux higher src/dummy.c
246-
# $(G11) $(CFLAGS) $(GDAL) $(GSL) $(CURL) $(SPLITS) $(OPENCV) $(PYTHON) $(PYTHON2) $(RSTATS) -o $(TB)/dummy src/dummy.c $(TC)/*.o $(TA)/*.o $(TH)/*.o $(LDGDAL) $(LDGSL) $(LDCURL) $(LDSPLITS) $(LDOPENCV) $(LDPYTHON) $(LDRSTATS)
246+
# $(G11) $(CFLAGS) $(GDAL) $(GSL) $(CURL) $(OPENCV) $(PYTHON) $(PYTHON2) $(RSTATS) -o $(TB)/dummy src/dummy.c $(TC)/*.o $(TA)/*.o $(TH)/*.o $(LDGDAL) $(LDGSL) $(LDCURL) $(LDOPENCV) $(LDPYTHON) $(LDRSTATS)
247247

248248

249249
##########################################################################

docs.sh

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,11 @@
11
#!/bin/bash
22

3-
make -j force-parameter
3+
make -j aux
44

5-
MOD=$(temp-bin/force-parameter -m | grep -v 'available modules' | sed 's/^ *//' | cut -d ':' -f 1)
5+
MOD=$(bin/force-parameter -m | grep -v 'available modules' | sed 's/^ *//' | cut -d ':' -f 1)
66

77
for m in $MOD; do
8-
temp-bin/force-parameter docs/source/_static/parameter-files/parameter_$m.prm $m
8+
bin/force-parameter docs/source/_static/parameter-files/parameter_$m.prm $m
99
done
1010

1111
make clean

docs/source/_static/parameter-files/parameter_TSA.prm

Lines changed: 0 additions & 69 deletions
Original file line numberDiff line numberDiff line change
@@ -406,75 +406,6 @@ OUTPUT_CAM = FALSE
406406
OUTPUT_CAW = FALSE
407407
OUTPUT_CAD = FALSE
408408

409-
# LAND SURFACE PHENOLOGY PARAMETERS - SPLITS-BASED
410-
# ------------------------------------------------------------------------
411-
# The Land Surface Phenology (LSP) options are only available if FORCE was
412-
# compiled with SPLITS (see installation section in the FORCE user guide).
413-
# ------------------------------------------------------------------------
414-
# For estimating LSP for one year, some data from the previous/next year
415-
# need to be considered to find the seasonal minima, which define a season.
416-
# The parameters are given in DOY, i.e. LSP_DOY_PREV_YEAR = 273, and
417-
# LSP_DOY_NEXT_YEAR = 91 will use all observations from October (Year-1)
418-
# to March (Year+1)
419-
# Type: Integer. Valid range: [1,365]
420-
LSP_DOY_PREV_YEAR = 273
421-
LSP_DOY_NEXT_YEAR = 91
422-
# Seasonality is of Northern-, Southern-hemispheric or of mixed type? If
423-
# mixed, the code will attempt to estimate the type on a per-pixel basis.
424-
# Type: Character. Valid values: {NORTH,SOUTH,MIXED}
425-
LSP_HEMISPHERE = NORTH
426-
# How many segments per year should be used for the spline fitting? More
427-
# segments follow the seasonality more closely, less segments smooth the
428-
# time series stronger.
429-
# Type: Integer. Valid range: [1,...
430-
LSP_N_SEGMENT = 4
431-
# Amplitude threshold for detecing Start, and End of Season, i.e. the date,
432-
# at which xx% of the amplitude is observed
433-
# Type: Float. Valid range: ]0,1[
434-
LSP_AMP_THRESHOLD = 0.2
435-
# LSP won't be derived if the seasonal index values do not exceed following
436-
# value. This is useful to remove unvegetated surfaces.
437-
# Type: Integer. Valid range: [-10000,10000]
438-
LSP_MIN_VALUE = 500
439-
# LSP won't be derived if the seasonal amplitude is below following value
440-
# This is useful to remove surfaces that do not have a seasonality.
441-
# Type: Integer. Valid range: [0,10000]
442-
LSP_MIN_AMPLITUDE = 500
443-
# Which Phenometrics should be computed? There will be a LSP output file for
444-
# each metric (with years as bands).
445-
# Currently available are the dates of the early minimum, start of season,
446-
# rising inflection, peak of season, falling inflection, end of season, late
447-
# minimum; lengths of the total season, green season; values of the early
448-
# minimum, start of season, rising inflection, peak of season, falling
449-
# inflection, end of season, late minimum, base level, seasonal amplitude;
450-
# integrals of the total season, base level, base+total, green season; rates
451-
# of average rising, average falling, maximum rising, maximum falling.
452-
# Type: Character list. Valid values: {DEM,DSS,DRI,DPS,DFI,DES,DLM,LTS,LGS,
453-
# VEM,VSS,VRI,VPS,VFI,VES,VLM,VBL,VSA,IST,IBL,IBT,IGS,RAR,RAF,RMR,RMF}
454-
LSP = VSS VPS VES VSA RMR IGS
455-
# Standardize the LSP time series with pixel mean and/or standard deviation?
456-
# Type: Logical. Valid values: {NONE,NORMALIZE,CENTER}
457-
STANDARDIZE_LSP = NONE
458-
# Output the Spline fit? This is a layer stack of fitted index values for
459-
# interpolated date.
460-
# Type: Logical. Valid values: {TRUE,FALSE}
461-
OUTPUT_SPL = FALSE
462-
# Output the Phenometrics? These are layer stacks per phenometric with as many
463-
# bands as years (excluding one year at the beginning/end of the time series).
464-
# Type: Logical. Valid values: {TRUE,FALSE}
465-
OUTPUT_LSP = FALSE
466-
# Compute and output a linear trend analysis on the requested Phenometric time
467-
# series? Note that the OUTPUT_LSP parameters don't need to be TRUE to do this.
468-
# See also the TREND PARAMETERS block below.
469-
# Type: Logical. Valid values: {TRUE,FALSE}
470-
OUTPUT_TRP = FALSE
471-
# Compute and output an extended Change, Aftereffect, Trend (CAT) analysis on
472-
# the requested Phenometric time series?
473-
# Note that the OUTPUT_LSP parameters don't need to be TRUE to do this.
474-
# See also the TREND PARAMETERS block below.
475-
# Type: Logical. Valid values: {TRUE,FALSE}
476-
OUTPUT_CAP = FALSE
477-
478409
# LAND SURFACE PHENOLOGY PARAMETERS - POLAR-BASED
479410
# ------------------------------------------------------------------------
480411
# Please note that these only work well with non-negative indices.--------

docs/source/components/higher-level/tsa/format.rst

Lines changed: 81 additions & 91 deletions
Original file line numberDiff line numberDiff line change
@@ -148,8 +148,6 @@ Example filename: 1984-2020_182-274_HL_TSA_LNDLG_TCG_STM.tif
148148
+ + TRX + Trend Analysis on Folds (replace X with Table 2) +
149149
+ +---------+---------------------------------------------------------+
150150
+ + CAX + Extended CAT Analysis on Folds (replace X with Table 2) +
151-
+ +---------+---------------------------------------------------------+
152-
+ + SPL + Spline fitted Time Series +
153151
+----------------+---------+---------------------------------------------------------+
154152
+ 36-42 + Product Type: Phenometrics (replace XXX with Table 3) +
155153
+ +---------+---------------------------------------------------------+
@@ -204,95 +202,87 @@ Phenology
204202

205203
**Table 3:** Phenology name tags
206204

207-
+-----+---------------------------------------------------+-------+--------+
208-
+ Tag + Description + Polar + SPLITS +
209-
+=====+===================================================+=======+========+
210-
+ DEM + Date of Early Minimum + X + X +
211-
+-----+---------------------------------------------------+-------+--------+
212-
+ DSS + Date of Start of Season + X + X +
213-
+-----+---------------------------------------------------+-------+--------+
214-
+ DRI + Date of Rising Inflection + + X +
215-
+-----+---------------------------------------------------+-------+--------+
216-
+ DPS + Date of Peak of Season + X + X +
217-
+-----+---------------------------------------------------+-------+--------+
218-
+ DMS + Date of Mid of Season + X + +
219-
+-----+---------------------------------------------------+-------+--------+
220-
+ DFI + Date of Falling Inflection + + X +
221-
+-----+---------------------------------------------------+-------+--------+
222-
+ DES + Date of End of Season + X + X +
223-
+-----+---------------------------------------------------+-------+--------+
224-
+ DLM + Date of Late Minimum + X + X +
225-
+-----+---------------------------------------------------+-------+--------+
226-
+ DEV + Date of Early Average Vector + X + +
227-
+-----+---------------------------------------------------+-------+--------+
228-
+ DAV + Date of Average Vector + X + +
229-
+-----+---------------------------------------------------+-------+--------+
230-
+ DLV + Date of Late Average Vector + X + +
231-
+-----+---------------------------------------------------+-------+--------+
232-
+ DPY + Date of Start of Phenological Year + X + +
233-
+-----+---------------------------------------------------+-------+--------+
234-
+ DPV + delta Date of adaptive Start of Phenological Year + X + +
235-
+-----+---------------------------------------------------+-------+--------+
236-
+ LTS + Length of Total Season + X + X +
237-
+-----+---------------------------------------------------+-------+--------+
238-
+ LGS + Length of Green Season + X + X +
239-
+-----+---------------------------------------------------+-------+--------+
240-
+ LGV + Length of between early/late vectors + X + +
241-
+-----+---------------------------------------------------+-------+--------+
242-
+ VEM + Value of Early Minimum + X + X +
243-
+-----+---------------------------------------------------+-------+--------+
244-
+ VSS + Value of Start of Season + X + X +
245-
+-----+---------------------------------------------------+-------+--------+
246-
+ VRI + Value of Rising Inflection + + X +
247-
+-----+---------------------------------------------------+-------+--------+
248-
+ VPS + Value of Peak of Season + X + X +
249-
+-----+---------------------------------------------------+-------+--------+
250-
+ VMS + Value of Mid of Season + X + +
251-
+-----+---------------------------------------------------+-------+--------+
252-
+ VFI + Value of Falling Inflection + + X +
253-
+-----+---------------------------------------------------+-------+--------+
254-
+ VES + Value of End of Season + X + X +
255-
+-----+---------------------------------------------------+-------+--------+
256-
+ VLM + Value of Late Minimum + X + X +
257-
+-----+---------------------------------------------------+-------+--------+
258-
+ VEV + Value of Early Average Vector + X + +
259-
+-----+---------------------------------------------------+-------+--------+
260-
+ VAV + Value of Average Vector + X + +
261-
+-----+---------------------------------------------------+-------+--------+
262-
+ VLV + Value of Late Average Vector + X + +
263-
+-----+---------------------------------------------------+-------+--------+
264-
+ VBL + Value of Base Level + X + X +
265-
+-----+---------------------------------------------------+-------+--------+
266-
+ VSA + Value of Seasonal Amplitude + X + X +
267-
+-----+---------------------------------------------------+-------+--------+
268-
+ VGA + Value of Green Amplitude + X + +
269-
+-----+---------------------------------------------------+-------+--------+
270-
+ VPA + Value of Peak Amplitude + X + +
271-
+-----+---------------------------------------------------+-------+--------+
272-
+ VGM + Value of Green Mean + X + +
273-
+-----+---------------------------------------------------+-------+--------+
274-
+ VGV + Value of Green Variability + X + +
275-
+-----+---------------------------------------------------+-------+--------+
276-
+ IST + Integral of Total Season + X + X +
277-
+-----+---------------------------------------------------+-------+--------+
278-
+ IBL + Integral of Base Level + X + X +
279-
+-----+---------------------------------------------------+-------+--------+
280-
+ IBT + Integral of Base+Total + X + X +
281-
+-----+---------------------------------------------------+-------+--------+
282-
+ IGS + Integral of Green Season + X + X +
283-
+-----+---------------------------------------------------+-------+--------+
284-
+ IRR + Integral of Rising Rate + X + +
285-
+-----+---------------------------------------------------+-------+--------+
286-
+ IFR + Integral of Falling Rate + X + +
287-
+-----+---------------------------------------------------+-------+--------+
288-
+ RAR + Rate of Average Rising + X + X +
289-
+-----+---------------------------------------------------+-------+--------+
290-
+ RAF + Rate of Average Falling + X + X +
291-
+-----+---------------------------------------------------+-------+--------+
292-
+ RMR + Rate of Maximum Rising + X + X +
293-
+-----+---------------------------------------------------+-------+--------+
294-
+ RMF + Rate of Maximum Falling + X + X +
295-
+-----+---------------------------------------------------+-------+--------+
205+
+-----+---------------------------------------------------+
206+
+ Tag + Description +
207+
+=====+===================================================+
208+
+ DEM + Date of Early Minimum +
209+
+-----+---------------------------------------------------+
210+
+ DSS + Date of Start of Season +
211+
+-----+---------------------------------------------------+
212+
+ DPS + Date of Peak of Season +
213+
+-----+---------------------------------------------------+
214+
+ DMS + Date of Mid of Season +
215+
+-----+---------------------------------------------------+
216+
+ DES + Date of End of Season +
217+
+-----+---------------------------------------------------+
218+
+ DLM + Date of Late Minimum +
219+
+-----+---------------------------------------------------+
220+
+ DEV + Date of Early Average Vector +
221+
+-----+---------------------------------------------------+
222+
+ DAV + Date of Average Vector +
223+
+-----+---------------------------------------------------+
224+
+ DLV + Date of Late Average Vector +
225+
+-----+---------------------------------------------------+
226+
+ DPY + Date of Start of Phenological Year +
227+
+-----+---------------------------------------------------+
228+
+ DPV + delta Date of adaptive Start of Phenological Year +
229+
+-----+---------------------------------------------------+
230+
+ LTS + Length of Total Season +
231+
+-----+---------------------------------------------------+
232+
+ LGS + Length of Green Season +
233+
+-----+---------------------------------------------------+
234+
+ LGV + Length of between early/late vectors +
235+
+-----+---------------------------------------------------+
236+
+ VEM + Value of Early Minimum +
237+
+-----+---------------------------------------------------+
238+
+ VSS + Value of Start of Season +
239+
+-----+---------------------------------------------------+
240+
+ VPS + Value of Peak of Season +
241+
+-----+---------------------------------------------------+
242+
+ VMS + Value of Mid of Season +
243+
+-----+---------------------------------------------------+
244+
+ VES + Value of End of Season +
245+
+-----+---------------------------------------------------+
246+
+ VLM + Value of Late Minimum +
247+
+-----+---------------------------------------------------+
248+
+ VEV + Value of Early Average Vector +
249+
+-----+---------------------------------------------------+
250+
+ VAV + Value of Average Vector +
251+
+-----+---------------------------------------------------+
252+
+ VLV + Value of Late Average Vector +
253+
+-----+---------------------------------------------------+
254+
+ VBL + Value of Base Level +
255+
+-----+---------------------------------------------------+
256+
+ VSA + Value of Seasonal Amplitude +
257+
+-----+---------------------------------------------------+
258+
+ VGA + Value of Green Amplitude +
259+
+-----+---------------------------------------------------+
260+
+ VPA + Value of Peak Amplitude +
261+
+-----+---------------------------------------------------+
262+
+ VGM + Value of Green Mean +
263+
+-----+---------------------------------------------------+
264+
+ VGV + Value of Green Variability +
265+
+-----+---------------------------------------------------+
266+
+ IST + Integral of Total Season +
267+
+-----+---------------------------------------------------+
268+
+ IBL + Integral of Base Level +
269+
+-----+---------------------------------------------------+
270+
+ IBT + Integral of Base+Total +
271+
+-----+---------------------------------------------------+
272+
+ IGS + Integral of Green Season +
273+
+-----+---------------------------------------------------+
274+
+ IRR + Integral of Rising Rate +
275+
+-----+---------------------------------------------------+
276+
+ IFR + Integral of Falling Rate +
277+
+-----+---------------------------------------------------+
278+
+ RAR + Rate of Average Rising +
279+
+-----+---------------------------------------------------+
280+
+ RAF + Rate of Average Falling +
281+
+-----+---------------------------------------------------+
282+
+ RMR + Rate of Maximum Rising +
283+
+-----+---------------------------------------------------+
284+
+ RMF + Rate of Maximum Falling +
285+
+-----+---------------------------------------------------+
296286

297287

298288
File format

docs/source/components/higher-level/tsa/index.rst

Lines changed: 3 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -66,13 +66,11 @@ hARD+ products can be directly used to fuel your research questions without any
6666
* If folded by day, the observations are grouped by DOY, which gives up to 365 values per pixel.
6767

6868
* Annual Land Surface Phenology (LSP) metrics a.k.a. phenometrics can be extracted.
69-
This option is only available if FORCE was compiled with SPLITS (see :ref:`depend-opt`).
70-
The SPLITS code fits a spline to the time series in a first step (can be output).
71-
The number of segments for fitting the splines need to be specified (in segments per year); more segments give a more detailed fit; the detail vs. smoothing capability of the spline needs to be considered with respect to application, land cover of interest and data density.
7269
Deriving LSP will only work nicely if data availability throughout the year is high; do not expect good results for sparse data.
7370
To derive LSP metrics for a given year, some data from the previous and next year need to be included, as the early/late minima may not be found in the year of interest (the data range can be specified by the user).
74-
The same can be true for the peak.
75-
The user can select if a Northern hemisphere (peak assumed in the middle of the year), Southern hemisphere (peak is assumed around the turn of the year) or mixed phenology (both can happen, let the program decide) should be assumed.
71+
The same can be true for the peak.
72+
The code will autodetect whether we have a Northern hemisphere (peak assumed in the middle of the year) or Southern hemisphere (peak is assumed around the turn of the year) type of phenology.
73+
This decision is taken on the pixel-level.
7674
In total, 26 LSP metrics can be derived for each year (see :ref:`tsa-format`).
7775

7876
* Trend analysis and/or an change/trend analyses can be performed on any of the folded and/or LSP time series.

0 commit comments

Comments
 (0)