PSCF - Polymer Self-Consistent Field

PSCF is a software package for field-theoretic simulation of inhomogeneous equilibrium structures formed by polymer liquids with constituents that tend to phase separate. The current version of PSCF can perform either self-consistent field theory calculations or stochastic field theoretic simulations that use a partial saddle-point approximation.

PSCF is written primarily in C++, supplemented by CUDA to use a NVIDIA graphics processing unit if one is available. The package is only distributed in source code form, and so must be compiled by the user. PSCF is designed for a unix-like environment, and is regularly tested on Linux and Mac OS X operating systems.

PSCF is free, open source software. It is distributed under the terms of the GNU General Public License as (GPL) published by the Free Software Foundation, either version 3 of the License or (at your option) any later version. See the LICENSE file or the gnu web page for details. Development of PSCF is currently supported by the National Science Foundation program for Cyberinfrastructure for Sustained Scientific Development (CSSI) under Grant No. 2103627.

Manual Organization:

This web manual is designed to provide both usage information for users who may never look at the source code and complete developer documentation for those who do.

Information for users about how to install and use PSCF is provided in chapters 1-5 of the web manual, as outlined below. Additional general information aimed at developers is given in chapter 6, Developer Information.

Detailed programming interface documentation aimed at developers is accessible via the "Topics", "Namespaces", "Classes", and "Files" tabs that appear at the top of every web manual page. The "Topics" page provides a hierarchical list of classes and functions, organized into C++ namespaces and, within each namespace, into groups of functionally related classes.

The web manual for the most recent release of PSCF is available online at https://dmorse.github.io/pscfpp-man .

Manual Contents:

1. About
   1. Computational Methods
   2. Package History
   3. Programs
   4. Features
   5. Contributors
2. Installation
   1. Requirements and Dependencies
   2. Getting the Source Code
   3. Installation Overview
   4. Environment Variables
   5. Configure Script
   6. Out-of-Source and In-Source Builds
   7. Compile Time Options
   8. Makefile targets
   9. Generating Documentation
3. User Introduction
   1. Model and Parameters
   2. Input Files
   3. Running a Program
   4. Types of Calculation
   5. Parameter Files
   6. Command Files
   7. Examples
4. Self-Consistent Field Theory
   1. Self-Consistent Field Theory
   2. Parameter Files
   3. Field Files
   4. Command Files
   5. Thermodynamic Properties
   6. Crystal Unit Cells
   7. Space Groups
   8. Environments – Confinement and External Fields
   9. Thin-Film Confinement
   10. Visualization
   11. Python Tools
   12. Appendix: Modified Diffusion Equations
   13. Appendix: Periodic Functions and Fourier Series
   14. Appendix: Space Group Symmetry
   15. Appendix: Symmetry-Adapted Bases
5. Partial Saddle-Point Field Theoretic Simulation (PS-FTS)
   1. Fully Fluctuating Field Theory - Incompressible Systems
   2. Partial Saddle-Point Approximation
   3. Algorithms
   4. Parameter File
   5. Command File
   6. Field Trajectory Files
   7. Parameter Ramps
   8. Perturbations
6. Developer Information
   1. Directory Structure
   2. Source File Lists
   3. Build System
   4. Coding Standards
   5. C++ Class Templates
   6. Parameter File I/O
   7. Unit Tests