Design¶

Modules¶

dnppy is divided into some thematic modules by purpose. Each module has its own page and some examples to get you started, but they are all used in a similar fashion. You can read more about each specific module on the modules summary page.

Functional Format¶

At heart, dnppy is a simple collection of classes and functions. Wherever possible, these functions are designed such that they can be assembled together in simple “chain-link” style sequence to perform manipulation and analysis on many files, typically raster data from a NASA sensor, by feeding the outputs of one function into the inputs of another. This approach makes otherwise complex programming tasks more accessible to novice programmers, and provides context for learning more foundational computer programming.

In the example below, foo_outputs, which is a list of the output files created by foo, was directly fed into the inputs for function bar

foo_outputs = foo(my_filelist, my_arg1)
bar_outputs = bar(foo_outputs, my_arg2)

This is accomplished by defining functions in a manner similar to the following:

def foo(input_filelist, other_argument):
    """ does something foo-ish """

    output_filelist = []
    for input_file in input_filelist:
        # do something to create an output_file
        output_filelist.append(output_file)

    return output_filelist


def bar(input_filelist, other_argument):
    """ does something bar-ish """

    output_filelist = []
    for input_file in input_filelist:
        # do something to create an output_file
        output_filelist.append(output_file)

    return output_filelist