lib.timelib module

Time conversion utilities

pygeotools.lib.timelib.center_date(dt1, dt2)

pygeotools.lib.timelib.decyear2dt(t)

Convert decimal year to datetime

pygeotools.lib.timelib.doy2dt(yr, j)

Convert year + integer DOY (Julian) to datetime

pygeotools.lib.timelib.dt2decyear(dt)

Convert datetime to decimal year

pygeotools.lib.timelib.dt2doy(dt)

Convert datetime to integer DOY (Julian)

pygeotools.lib.timelib.dt2jd(dt)

Convert datetime to julian date

pygeotools.lib.timelib.dt2mat(dt)

Convert Python datetime to Matlab ordinal

pygeotools.lib.timelib.dt2o(dt)

Convert datetime to Python ordinal

pygeotools.lib.timelib.dt_check(dt)

pygeotools.lib.timelib.dt_cluster(dt_list, dt_thresh=16.0)

Find clusters of similar datetimes within datetime list

pygeotools.lib.timelib.dt_filter_rel_annual_idx(dt_list, min_rel_dt=(1, 1), max_rel_dt=(12, 31))

Return dictionary containing indices of timestamps that fall within relative month/day bounds of each year

pygeotools.lib.timelib.dt_ptp(dt_list)

pygeotools.lib.timelib.dt_range(dt1, dt2, interval)

pygeotools.lib.timelib.filter_fn_list(dt, fn_list, pad)

pygeotools.lib.timelib.fix_repeat_dt(dt_list, offset_s=0.001)

Add some small offset to remove duplicate times Needed for xarray interp, which expects monotonically increasing times

pygeotools.lib.timelib.fn_getdatetime(fn)

Extract datetime from input filename

pygeotools.lib.timelib.fn_getdatetime_list(fn)

Extract all datetime strings from input filename

pygeotools.lib.timelib.gen_ts_fn(fn, dt_ref=None, ma=False)

pygeotools.lib.timelib.getLocalTime(utc_dt, tz)

Return local timezone time

pygeotools.lib.timelib.getTimeZone(lat, lon)

Get timezone for a given lat/lon

pygeotools.lib.timelib.get_closest_dt_fn(fn, fn_list)

pygeotools.lib.timelib.get_closest_dt_idx(dt, dt_list)

Get indices of dt_list that is closest to input dt

pygeotools.lib.timelib.get_closest_dt_padded_idx(dt, dt_list, pad=datetime.timedelta(30))

Get indices of dt_list that is closest to input dt +/- pad days

pygeotools.lib.timelib.get_dt_bounds(dt_list, min_rel_dt=(1, 1), max_rel_dt=(12, 31))

pygeotools.lib.timelib.get_dt_bounds_fn(list_fn, min_rel_dt=(5, 31), max_rel_dt=(6, 1))

pygeotools.lib.timelib.get_dt_bounds_monthyear(dt_list)

pygeotools.lib.timelib.get_dt_list(fn_list)

Get list of datetime objects, extracted from a filename

pygeotools.lib.timelib.get_t_factor(t1, t2)

Time difference between two datetimes, expressed as decimal year

pygeotools.lib.timelib.get_t_factor_fn(fn1, fn2, ds=None)

pygeotools.lib.timelib.get_unique_monthyear(dt_list)

pygeotools.lib.timelib.get_unique_years(dt_list)

pygeotools.lib.timelib.gps2dt(gps_week, gps_ms)

Convert GPS week and ms to a datetime

pygeotools.lib.timelib.jd2dt(jd)

Convert julian date to datetime

pygeotools.lib.timelib.mat2dt(o)

Convert Matlab ordinal to Python datetime

Need to account for AD 0 and AD 1 discrepancy between the two: http://sociograph.blogspot.com/2011/04/how-to-avoid-gotcha-when-converting.html

python_datetime = datetime.fromordinal(int(o)) + timedelta(days=o%1) - timedelta(days = 366)

pygeotools.lib.timelib.mean_date(dt_list)

Calcuate mean datetime from datetime list

pygeotools.lib.timelib.median_date(dt_list)

Calcuate median datetime from datetime list

pygeotools.lib.timelib.mid_date(dt_list)

pygeotools.lib.timelib.o2dt(o)

Convert Python ordinal to datetime

pygeotools.lib.timelib.print_dt(dt)

pygeotools.lib.timelib.rel_dt_list_idx(dt_list, min_rel_dt=(1, 1), max_rel_dt=(12, 31))

pygeotools.lib.timelib.rel_dt_test(dt, min_rel_dt=(1, 1), max_rel_dt=(12, 31))

pygeotools.lib.timelib.round_dt(dt)

pygeotools.lib.timelib.seconds2timedelta(s)

pygeotools.lib.timelib.sinceEpoch(dt)

pygeotools.lib.timelib.solarTime(utc_dt, lat, lon)

Compute local solar time for given (lat, lon)

pygeotools.lib.timelib.sort_fn_list(fn_list)

Sort input filename list by datetime

pygeotools.lib.timelib.strptime_fuzzy(s)

Fuzzy date string parsing

Note: this returns current date if not found. If only year is provided, will return current month, day

pygeotools.lib.timelib.timedelta2decdays(d)

pygeotools.lib.timelib.timedelta2decyear(d)

pygeotools.lib.timelib.timedelta_div(t, d)

pygeotools.lib.timelib.tsx_cdate(t1)

pygeotools.lib.timelib.tsx_cdate_print(t1)

pygeotools.lib.timelib.tsx_orbit2dt(orbits)

pygeotools.lib.timelib.ul_time(utc_dt, lon)

Compute local time for input longitude

pygeotools.lib.timelib.uniq_days_dt(dt_list)

pygeotools.lib.timelib.uniq_days_o(dt_list)