Source Files

the main pic module interface: versions, banners, random quotes etc will go here

ANSI escape sequences, key decoding and flicker-free frame composition.

pic array contains L0.5 BLAS level routines, as in things that could be use in lieu of blas if you don’t have it but if you do, please don’t use these routines

State hashing of whole intrinsic arrays, for checkpoint validation and cross-run comparison.

This file contains the module that handles all ASCII related business

Command line parsing: declare the interface, then read it.

Monotonic elapsed time and wall-clock date and time.

The pic_command_line.f90 file will contain all routines that will interact with the command line

all things constants, physical, chemical, etc

Compressed sparse row (CSR) matrix storage and the core CSR kernels.

Error handling module for pic Provides a unified error type to replace stat/errmsg pairs Enhanced with stack trace support for better debugging

Bounded, fixed-capacity arrays with no heap allocation in the hot path. The Fortran analogue of C++’s std::inplace_vector: push/pop/size semantics on top of storage that lives entirely inside the object.

flop rate handler modules

flop recorder

Deterministic number-to-string formatting.

this is an experimental file that contains definitions that will be uses across the program, for example input/output units that PIC will use across things.

Graph traversal and shortest-path algorithms over CSR adjacency.

Contains the 32 bit hashing routines

FNV_1_HASH and FNV_1A_Hash are translations to Fortran 2008 of the FNV-1 and FNV-1a hash functions of Glenn Fowler, Landon Curt Noll, and Phong Vo, that has been released into the public domain. Permission has been granted, by Landon Curt Noll, for the use of these algorithms in the Fortran Standard Library. A description of these functions is available at https://en.wikipedia.org/wiki/Fowler–Noll–Vo_hash_function.

Insertion-ordered hash map with character keys and 64-bit integer values.

Binary heap / priority queue with stable (FIFO) tie-breaking.

General helpers

this file contains “helper” routines, for example printing a set amount of x characters to creates tables, etc.

the gathered knowledge of the species

the pic_logger.f90 is the base file that defines the logger function this is heavily inspired by the logger from the standard library but with some key changes for my purposes. The logger will be the way in which the code interacts with the output to console and files

Scalar numeric utility functions: range clamping, range checking, and approximate floating-point equality.

Optional value handling module

Portable profiler with NVTX range support

pic_pure_logger.f90 provides a pure-compatible logger for use inside pure functions and subroutines. Since I/O is forbidden in pure contexts, messages are cached into a log_buffer_type that must be flushed by the caller once execution returns to an impure context.

Integer-valued random distributions, reproducible across compilers.

Real-valued random distributions, for tooling and statistics.

Reproducible pseudo-random number generation with explicit state.

Binary serialization helpers built on a small, self-describing envelope.

Runtime substrate for struct-of-arrays (SoA) containers.

Struct-of-arrays container for particle data.

This file is subject both to the Fortran Standard Library license, and to additional licensing requirements as it contains translations of other software.

This file is subjec† both to the Fortran Standard Library license, and to additional licensing requirements as it contains translations of other software.

Shared run_type derived type for the ord_sort and sort_index submodules.

This file is subject both to the Fortran Standard Library license, and to additional licensing requirements as it contains translations of other software.

This file is subjec† both to the Fortran Standard Library license, and to additional licensing requirements as it contains translations of other software.

Basic descriptive statistics for 1-D arrays: mean, variance, standard deviation and combined min/max.

String derived type container

contains the definitions for building strings from different data types

string manipulation module and subroutines

Contains the submodule that defines the to_string functions used to handle and manipulate strings

timing routines in general

String splitting and checked numeric parsing.

pic_types.F90 controls the standarized sizes for the datatypes across pic, this is key for interfacing with other codes specially those that use default sizes

Arithmetic modulo 2**64 on integer(int64), without signed overflow.

Growable, heap-backed arrays with bounds-checked access.