source: branches/blt4/examples/objects/app-fermi/c/ex3/fermi.c @ 1824

// ----------------------------------------------------------------------
//  EXAMPLE: Fermi-Dirac function in C
//
//  This simple example shows how to use Rappture within a simulator
//  written in C.
// ======================================================================
//  AUTHOR:  Derrick Kearney, Purdue University
//  Copyright (c) 2005-2009  Purdue Research Foundation
//
//  See the file "license.terms" for information on usage and
//  redistribution of this file, and for a DISCLAIMER OF ALL WARRANTIES.
// ======================================================================

#include "rappture.h"

#include <stdlib.h>
#include <stdio.h>
#include <math.h>
#include <unistd.h>

#include "fermi_io.c"

int main(int argc, char * argv[]) {

    // declare variables to interact with Rappture
    double T          = 0.0;
    double Ef         = 0.0;
    Rp_TableColumn *x1 = NULL;
    Rp_TableColumn *y1 = NULL;
    Rp_TableColumn *x2 = NULL;
    Rp_TableColumn *y2 = NULL;


    // declare program variables
    double E          = 0.0;
    double dE         = 0.0;
    double kT         = 0.0;
    double Emin       = 0.0;
    double Emax       = 0.0;
    double f          = 0.0;
    size_t nPts       = 200;
    double EArr[nPts];
    double EArr2[nPts];
    double fArr[nPts];
    double fArr2[nPts];

    // initialize the global interface
    Rp_InterfaceInit(argc,argv,&fermi_io);

    // check the global interface for errors
    if (Rp_InterfaceError() != 0) {
        // there were errors while setting up the interface
        // dump the traceback
        Rp_Outcome *o = Rp_InterfaceOutcome();
        fprintf(stderr, "%s", Rp_OutcomeContext(o));
        fprintf(stderr, "%s", Rp_OutcomeRemark(o));
        return(Rp_InterfaceError());
    }

    // connect variables to the interface
    // look in the global interface for an object named
    // "temperature", convert its value to Kelvin, and
    // store the value into the address of T.
    // look in the global interface for an object named
    // "Ef", convert its value to electron Volts and store
    // the value into the address of Ef.
    // look in the global interface for the columns to
    // store data. retrieve them for later use.
    Rp_InterfaceConnect("temperature",&T,"units=K",NULL);
    Rp_InterfaceConnect("Ef",&Ef,"units=eV",NULL);

    Rp_InterfaceConnect("Fermi-Dirac Factor",x1,NULL);
    Rp_InterfaceConnect("Energy",y1,NULL);
    Rp_InterfaceConnect("Fermi-Dirac Factor * 2",x2,NULL);
    Rp_InterfaceConnect("Energy * 2",y2,NULL);

    // check the global interface for errors
    if (Rp_InterfaceError() != 0) {
        // there were errors while retrieving input data values
        // dump the traceback
        Rp_Outcome *o = Rp_InterfaceOutcome();
        fprintf(stderr, "%s", Rp_OutcomeContext(o));
        fprintf(stderr, "%s", Rp_OutcomeRemark(o));
        return(Rp_InterfaceError());
    }

    // do science calculations
    kT = 8.61734e-5 * T;
    Emin = Ef - (10*kT);
    Emax = Ef + (10*kT);

    dE = (1.0/nPts)*(Emax-Emin);

    E = Emin;
    for(size_t idx = 0; idx < nPts; idx++) {
        E = E + dE;
        f = 1.0/(1.0 + exp((E - Ef)/kT));
        fArr[idx] = f;
        fArr2[idx] = f*2;
        EArr[idx] = E;
        EArr2[idx] = E*2;
        Rp_UtilsProgress((int)((E-Emin)/(Emax-Emin)*100),"Iterating");
    }

    // store results in the results table
    // add data to the table pointed to by the variable result.
    // put the fArr data in the column named "Fermi-Dirac Factor"
    // put the EArr data in the column named "Energy"
    //
    Rp_TableColumnStoreDouble(x1,nPts,fArr);
    Rp_TableColumnStoreDouble(y1,nPts,EArr);
    Rp_TableColumnStoreDouble(x2,nPts,fArr2);
    Rp_TableColumnStoreDouble(y2,nPts,EArr2);

    // close the global interface
    // signal to the graphical user interface that science
    // calculations are complete and to display the data
    // as described in the views
    Rp_InterfaceClose();

    return 0;
}