SpecifiedSmoothSuperellipsoidIC

under construction:Undocumented Class

The SpecifiedSmoothSuperellipsoidIC has not been documented. The content listed below should be used as a starting point for documenting the class, which includes the typical automatic documentation associated with a MooseObject; however, what is contained is ultimately determined by what is necessary to make the documentation clear for users.


# SpecifiedSmoothSuperellipsoidIC

!syntax description /ICs/SpecifiedSmoothSuperellipsoidIC

## Overview

!! Replace these lines with information regarding the SpecifiedSmoothSuperellipsoidIC object.

## Example Input File Syntax

!! Describe and include an example of how to use the SpecifiedSmoothSuperellipsoidIC object.

!syntax parameters /ICs/SpecifiedSmoothSuperellipsoidIC

!syntax inputs /ICs/SpecifiedSmoothSuperellipsoidIC

!syntax children /ICs/SpecifiedSmoothSuperellipsoidIC

Multiple smooth superellipsoids with manually specified center points; semiaxes a,b,c; and exponents n

Input Parameters

asSemiaxis a for each superellipsoid
C++ Type:std::vector
Options:
Description:Semiaxis a for each superellipsoid
bsSemiaxis b for each superellipsoid
C++ Type:std::vector
Options:
Description:Semiaxis b for each superellipsoid
csSemiaxis c for each superellipsoid
C++ Type:std::vector
Options:
Description:Semiaxis c for each superellipsoid
invalueThe variable value inside the superellipsoid
C++ Type:double
Options:
Description:The variable value inside the superellipsoid
nsExponent n for each superellipsoid
C++ Type:std::vector
Options:
Description:Exponent n for each superellipsoid
outvalueThe variable value outside the superellipsoid
C++ Type:double
Options:
Description:The variable value outside the superellipsoid
variableThe variable this initial condition is supposed to provide values for.
C++ Type:VariableName
Options:
Description:The variable this initial condition is supposed to provide values for.
x_positionsThe x-coordinate for each superellipsoid center
C++ Type:std::vector
Options:
Description:The x-coordinate for each superellipsoid center
y_positionsThe y-coordinate for each superellipsoid center
C++ Type:std::vector
Options:
Description:The y-coordinate for each superellipsoid center
z_positionsThe z-coordinate for each superellipsoid center
C++ Type:std::vector
Options:
Description:The z-coordinate for each superellipsoid center

Required Parameters

blockThe list of block ids (SubdomainID) that this object will be applied
C++ Type:std::vector
Options:
Description:The list of block ids (SubdomainID) that this object will be applied
boundaryThe list of boundary IDs from the mesh where this boundary condition applies
C++ Type:std::vector
Options:
Description:The list of boundary IDs from the mesh where this boundary condition applies
int_width0The interfacial width of the void surface. Defaults to sharp interface
Default:0
C++ Type:double
Options:
Description:The interfacial width of the void surface. Defaults to sharp interface
nestedvalueThe variable value for nested particles inside the superellipsoid in inverse configuration
C++ Type:double
Options:
Description:The variable value for nested particles inside the superellipsoid in inverse configuration
rand_seed12345Seed value for the random number generator
Default:12345
C++ Type:unsigned int
Options:
Description:Seed value for the random number generator
zero_gradientFalseSet the gradient DOFs to zero. This can avoid numerical problems with higher order shape functions.
Default:False
C++ Type:bool
Options:
Description:Set the gradient DOFs to zero. This can avoid numerical problems with higher order shape functions.

Optional Parameters

control_tagsAdds user-defined labels for accessing object parameters via control logic.
C++ Type:std::vector
Options:
Description:Adds user-defined labels for accessing object parameters via control logic.
enableTrueSet the enabled status of the MooseObject.
Default:True
C++ Type:bool
Options:
Description:Set the enabled status of the MooseObject.
ignore_uo_dependencyFalseWhen set to true, a UserObject retrieved by this IC will not be executed before the this IC
Default:False
C++ Type:bool
Options:
Description:When set to true, a UserObject retrieved by this IC will not be executed before the this IC

Advanced Parameters

Input Files

modules/phase_field/test/tests/initial_conditions/SpecifiedSmoothSuperellipsoidIC.i

modules/phase_field/test/tests/initial_conditions/SpecifiedSmoothSuperellipsoidIC.i

[Mesh]
  type = GeneratedMesh
  dim = 2
  nx = 25
  ny = 25
  xmax = 50
  ymax = 50
  elem_type = QUAD4
[]

[Variables]
  [./c]
    order = THIRD
    family = HERMITE
  [../]
[]

[ICs]
  [./c]
    type = SpecifiedSmoothSuperellipsoidIC
    variable = c
    x_positions = '15 35'
    y_positions = '25.0 25.0'
    z_positions = '0 0'
    as = '8.0 8.0'
    bs = '12.0 8.0'
    cs = '60.0 8.0'
    ns = '3.5 2.0'
    invalue = 1.0
    outvalue = -0.8
    int_width = 4.0
  [../]
[]

[Kernels]
  [./ie_c]
    type = TimeDerivative
    variable = c
  [../]
  [./CHSolid]
    type = CHMath
    variable = c
    mob_name = M
  [../]
  [./CHInterface]
    type = CHInterface
    variable = c
    kappa_name = kappa_c
    mob_name = M
  [../]
[]

[BCs]
  [./Periodic]
    [./all]
      auto_direction = 'x y'
    [../]
  [../]
[]

[Materials]
  [./constant]
    type = GenericConstantMaterial
    prop_names  = 'M kappa_c'
    prop_values = '1.0 1.0'
  [../]
[]

[Executioner]
  type = Transient
  scheme = 'bdf2'
  solve_type = 'NEWTON'

  petsc_options_iname = '-pc_type -pc_hypre_type -ksp_gmres_restart'
  petsc_options_value = 'hypre boomeramg 31'

  l_max_its = 20
  l_tol = 1.0e-4
  nl_max_its = 40
  nl_rel_tol = 1e-9

  start_time = 0.0
  num_steps = 1
  dt = 2.0
[]

[Outputs]
  exodus = false
  [./out]
    type = Exodus
    refinements = 2
  [../]
[]

Child Objects

modules/phase_field/include/ics/BimodalSuperellipsoidsIC.h

modules/phase_field/include/ics/BimodalSuperellipsoidsIC.h

// This file is part of the MOOSE framework
// https://www.mooseframework.org
//
// All rights reserved, see COPYRIGHT for full restrictions
// https://github.com/idaholab/moose/blob/master/COPYRIGHT
//
// Licensed under LGPL 2.1, please see LICENSE for details
// https://www.gnu.org/licenses/lgpl-2.1.html

#pragma once

#include "SpecifiedSmoothSuperellipsoidIC.h"

// Forward Declarations
class BimodalSuperellipsoidsIC;

template <>
InputParameters validParams<BimodalSuperellipsoidsIC>();

/**
 * BimodalSuperellipsoidsIC takes a specified number of superellipsoids, each with given parameters
 * These are intended to be the larger particles. Then the IC creates a specified number
 * of particles at random locations. These are the smaller particles. As each random particle
 * is placed, it it checked to make sure it does not collide with previously placed particles
 * (either
 * large or small ones). Variables to describe the specified (larger) superellipsoids are inherited
 * from the parent class.
 */
class BimodalSuperellipsoidsIC : public SpecifiedSmoothSuperellipsoidIC
{
public:
  BimodalSuperellipsoidsIC(const InputParameters & parameters);

  virtual void initialSetup();

protected:
  virtual void computeSuperellipsoidCenters();
  virtual void computeSuperellipsoidSemiaxes();
  virtual void computeSuperellipsoidExponents();

  ///@{ Variables to describe the randomly placed (smaller) superellipsoids
  unsigned int _npart;
  Real _small_spac;
  Real _large_spac;
  Real _small_a;
  Real _small_b;
  Real _small_c;
  Real _small_n;
  const Real _size_variation;
  const MooseEnum _size_variation_type;
  ///@}

  const unsigned int _max_num_tries;

  Point _bottom_left;
  Point _top_right;
  Point _range;
};

Input Parameters
Input Files
Child Objects

Application Usage

Physics and Syntax

Application Development

Framework Development

MOOSEDocs

Infrastructure

Questions

Information and Tools