org.agmip.functions

Class ExperimentHelper

java.lang.Object

org.agmip.functions.ExperimentHelper

public class ExperimentHelper
extends Object

Provide static functions for experiment data handling

Version:

0.1

Author:

Meng Zhang

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ExperimentHelper.EventType Event Type

Constructor Summary

Constructors

Constructor and Description
ExperimentHelper()

Method Summary

Methods

Modifier and Type	Method and Description
static HashMap<String,String>	createEvent(HashMap data, String typeStr, String dap, HashMap<String,String> info, boolean isStrictID) Generate event data with given information
static ArrayList<ArrayList<HashMap<String,String>>>	getAutoEvent(Map data)
static ArrayList<ArrayList<HashMap<String,String>>>	getAutoEventDate(Map data) This function will clone the original management events for each year in the experiment duration.
static ArrayList<ArrayList<HashMap<String,String>>>	getAutoEventDate(Map data, String[] pdates) This function will clone the original management events based on given new planting dates.
static HashMap<String,ArrayList<String>>	getAutoFillPlantingDate(HashMap data, String eDate, String lDate, String rain, String days) This function will calculate the planting date which is the first date within the planting window that has an accumulated rainfall amount (P) in the previous n days.
static ArrayList<HashMap<String,String>>	getAutoIrrigationEvent(HashMap data, String irrNum, String baseTemp, String[] gddArr, String[] irvalArr)
static HashMap<String,ArrayList<String>>	getAutoPlantingDate(HashMap data, String eDate, String lDate, String rain, String days) This function will calculate the planting date which is the first date within the planting window that has an accumulated rainfall amount (P) in the previous n days.
static ArrayList<HashMap<String,String>>	getFertDistribution(HashMap data, String num, String fecd, String feacd, String fedep, String[] offsets, String[] ptps) Often the total amount of fertilizer in a growing season has been recorded, but no details of application dates, types of fertilizer,etc.
static String	getFstPdate(Map data, String defValue) Get the first planting date from given data set.
protected static ArrayList	getICLayer(HashMap data) Get initial condition soil layer data array from data holder.
static ArrayList<HashMap<String,String>>	getOMDistribution(HashMap expData, String offset, String omcd, String omc2n, String omdep, String ominp, String dmr) Organic matter applications include manure, crop residues, etc.
static ArrayList<HashMap<String,String>>	getPaddyIrrigation(HashMap data, String bundNum, String percRate, String plowpanDept, String[] offsets, String[] maxVals, String[] minVals) This function allows standard paddy management inputs to be generalized for a field or group of fields.
static HashMap<String,ArrayList<String>>	getStableCDistribution(HashMap data, String som3_0, String pp, String rd) Calculate Stable C (g[C]/100g[soil]) fraction distribution in soil layers and save the result into initial condition layers

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ExperimentHelper

public ExperimentHelper()

Method Detail

getAutoPlantingDate

public static HashMap<String,ArrayList<String>> getAutoPlantingDate(HashMap data,
                                                    String eDate,
                                                    String lDate,
                                                    String rain,
                                                    String days)

This function will calculate the planting date which is the first date within the planting window
that has an accumulated rainfall amount (P) in the previous n days.

Parameters:

data - The HashMap of experiment (including weather data)

eDate - Earliest planting date (mm-dd or mmdd)

lDate - Latest planting date (mm-dd or mmdd)

rain - Threshold rainfall amount (mm)

days - Number of days of accumulation

Returns:

An ArrayList of pdate for each year in the weather data.

getAutoFillPlantingDate

public static HashMap<String,ArrayList<String>> getAutoFillPlantingDate(HashMap data,
                                                        String eDate,
                                                        String lDate,
                                                        String rain,
                                                        String days)

This function will calculate the planting date which is the first date within the planting window
that has an accumulated rainfall amount (P) in the previous n days. The calculation will be done then planting date is missing in the valid planting event.

Parameters:

data - The HashMap of experiment (including weather data)

eDate - Earliest planting date (mm-dd or mmdd)

lDate - Latest planting date (mm-dd or mmdd)

rain - Threshold rainfall amount (mm)

days - Number of days of accumulation

Returns:

An ArrayList of pdate for each year in the weather data.

getFertDistribution

public static ArrayList<HashMap<String,String>> getFertDistribution(HashMap data,
                                                    String num,
                                                    String fecd,
                                                    String feacd,
                                                    String fedep,
                                                    String[] offsets,
                                                    String[] ptps)

Often the total amount of fertilizer in a growing season has been recorded, but no details of application dates, types of fertilizer,etc. This function allows a user to specify rules for fertilizer application in a region. As a result, "N" fertilizer events are added to the JSON object.

Parameters:

num - Number of fertilizer applications

fecd - The code for type of fertilizer added

feacd - The code for fertilizer application method

fedep - The depth at which fertilizer is applied (cm)

offsets - The array of date as offset from planting date (days) (must be paired with ptps)

ptps - The array of proportion of total N added (%) (must be paired with offsets, the sum must be 100%)

data - The experiment data holder

Returns:

An ArrayList of generated fertilizer event based on each planting date

getOMDistribution

public static ArrayList<HashMap<String,String>> getOMDistribution(HashMap expData,
                                                  String offset,
                                                  String omcd,
                                                  String omc2n,
                                                  String omdep,
                                                  String ominp,
                                                  String dmr)

Organic matter applications include manure, crop residues, etc. As a result, the organic matter application event is updated with missing data.

Parameters:

expData - The experiment data holder

offset - application date as days before (-) or after (+) planting date (days)

omcd - code for type of fertilizer added

omc2n - C:N ratio for applied organic matter

omdep - depth at which organic matter is incorporated (cm)

ominp - percentage incorporation of organic matter (%)

dmr -

Returns:

An updated ArrayList of event, the generated or updated Organic matter event will be included and sorted inside the ArrayList

getStableCDistribution

public static HashMap<String,ArrayList<String>> getStableCDistribution(HashMap data,
                                                       String som3_0,
                                                       String pp,
                                                       String rd)

Calculate Stable C (g[C]/100g[soil]) fraction distribution in soil layers and save the result into initial condition layers

Parameters:

data - The experiment data holder

som3_0 - fraction of total soil organic C which is stable, at surface (fraction)

pp - depth of topsoil where maximum SOM3 fraction is relatively constant (cm)

rd - depth at which soil C is relatively stable (~98% stable C) (cm)

Returns:

An ArrayList of calculated SLSC for each layer of given soil

getAutoEventDate

public static ArrayList<ArrayList<HashMap<String,String>>> getAutoEventDate(Map data)

This function will clone the original management events for each year in the experiment duration. Only the date of each event will be increased year by year. If experiment duration is no longer than 1 year, no generation will be executed.

Parameters:

data - The HashMap of experiment (including weather data)

Returns:

Several groups of ArrayList of Event for each year in the experiment duration. The original group of Event will only be included when duration > 1.

getAutoEvent

public static ArrayList<ArrayList<HashMap<String,String>>> getAutoEvent(Map data)

getAutoEventDate

public static ArrayList<ArrayList<HashMap<String,String>>> getAutoEventDate(Map data,
                                                            String[] pdates)

This function will clone the original management events based on given new planting dates. The generated event will keep the original days after planting date (DAP). For example: New event date = New planting date + original DAP.

Parameters:

data - The HashMap of experiment (including weather data)

pdates - The given planting dates for generation

Returns:

Several groups of ArrayList of Event for each planting date in the experiment duration.

getPaddyIrrigation

public static ArrayList<HashMap<String,String>> getPaddyIrrigation(HashMap data,
                                                   String bundNum,
                                                   String percRate,
                                                   String plowpanDept,
                                                   String[] offsets,
                                                   String[] maxVals,
                                                   String[] minVals)

This function allows standard paddy management inputs to be generalized for a field or group of fields.

Parameters:

data - The experiment data holder

bundNum - Number of Bund height entries

percRate - The Percolation rate (mm/d)

plowpanDept - The Plowpan depth (mm)

offsets - The array of date as offset from planting date (days) (must be paired with Max and Min)

maxVals - The array of Max flood (bund) height (mm)

minVals - The array of Min flood height (mm)

Returns:

An ArrayList of generated irrigation event based on first planting date

getFstPdate

public static String getFstPdate(Map data,
                 String defValue)

Get the first planting date from given data set.

Parameters:

data - The experiment data holder

defValue - The value used for return when planting date is unavailable

Returns:

The planting date

createEvent

public static HashMap<String,String> createEvent(HashMap data,
                                 String typeStr,
                                 String dap,
                                 HashMap<String,String> info,
                                 boolean isStrictID)

Generate event data with given information

Parameters:

data - experiment data holder

typeStr - The event type

dap - The days after planting to operate the event

info - The given event information

isStrictID - The flag for if check the id is only belong the given event type

Returns:

The generated event

getAutoIrrigationEvent

public static ArrayList<HashMap<String,String>> getAutoIrrigationEvent(HashMap data,
                                                       String irrNum,
                                                       String baseTemp,
                                                       String[] gddArr,
                                                       String[] irvalArr)

getICLayer

protected static ArrayList getICLayer(HashMap data)

Get initial condition soil layer data array from data holder.

Parameters:

data - The experiment data holder

Returns:

The soil layer data array