"""Ideal single-RC sampling calculation. No device access or circuit simulation."""
import csv
import math
from pathlib import Path

def held(vin, initial, resistance, capacitance, seconds):
    return vin + (initial-vin)*math.exp(-seconds/(resistance*capacitance))

def calculate():
    vin, initial, vref, bits, capacitance = 3.0, 0.0, 3.3, 12, 20e-12
    rth = 100000*100000/(100000+100000)
    lsb = vref/(2**bits)
    tau = rth*capacitance
    minimum = tau*math.log(abs(vin-initial)/(lsb/2))
    checks = {
        "divider_voltage": 6.0*100000/(100000+100000) == vin,
        "parallel_source_resistance": rth == 50000,
        "time_constant": math.isclose(tau, 1e-6),
        "two_us_voltage": math.isclose(held(vin, initial, rth, capacitance, 2e-6), 2.593994150290162, abs_tol=1e-12),
        "two_us_error_codes": 503 < (vin-held(vin, initial, rth, capacitance, 2e-6))/lsb < 505,
        "nine_us_half_step": vin-held(vin, initial, rth, capacitance, 9e-6) < lsb/2,
        "minimum_acquisition": 8.91e-6 < minimum < 8.92e-6,
        "lower_resistance_current_cost": math.isclose((6/20000)/(6/200000), 10),
        "leakage_error": math.isclose(10e-9*rth, 0.0005),
        "full_scale_step_factor": math.isclose((bits+1)*math.log(2), 9.010913347279288),
    }
    assert all(checks.values())
    rows = []
    for t_us in [0, 0.5, 1, 2, 5, 9, 10]:
        for resistance in [50000, 5000]:
            value = held(vin, initial, resistance, capacitance, t_us*1e-6)
            rows.append({"time_us":t_us,"R_source_ohm":resistance,"C_F":capacitance,"Vin_V":vin,"V_initial_V":initial,"V_held_V":value,"settling_error_V":vin-value})
    with Path(__file__).with_suffix('.csv').open('w', newline='', encoding='utf-8') as f:
        writer=csv.DictWriter(f,fieldnames=rows[0].keys());writer.writeheader();writer.writerows(rows)
    return {"checks":checks,"executed_scalar_checks":len(checks),"Rth_ohm":rth,"tau_s":tau,"LSB_V":lsb,"half_LSB_V":lsb/2,"required_time_s":minimum,"voltage_at_2us_V":held(vin,initial,rth,capacitance,2e-6),"error_at_9us_V":vin-held(vin,initial,rth,capacitance,9e-6),"assumptions":"Ideal fixed3V input; initial capacitor0V; ideal switch; no leakage, extra capacitance, input movement, charge injection or reference error; not a part specification."}

if __name__ == '__main__':
    import json
    print(json.dumps(calculate(),indent=2))
