Create_MultDispCycleswN

Purpose

sequence of full, half or quarter displacement cycles with axial force

Synopsis

[DspHst,FrcHst] = Create_MultDispCycleswN (DspPat,Ucyc,Ncyc,TmStr,Options)

Description

CREATE_MULTDISPCYCLESwN sequence of full, half or quarter displacement cycles with axial force 
  [DSPHST,FRCHST] = CREATE_MULTDISPCYCLESwN (DSPPAT,UCYC,NCYC,TMSTR,OPTIONS)
  the function generates a sequence of full, half or quarter displacement cycles
  after factoring each with the corresponding factor in array UCYC;
  the axial force factor of the correponding cycle is specified in the optional array NCYC;
  UCYC is an ND x NCYC array and NCYC is a 1 x NCYC row vector, where ND is the number
  of imposed displacements/forces (1=uniaxial, 2=biaxial) and NCYC is the number of cycles;
  if NCYC is not specified, it is assumed equal to ONES(1,NCYC);
  the function returns the displacement history in the data structure array DSPHST
  with the fields Time and Value and the axial force history in the data structure FRCHST
  with the fields Time and Value; the data structure array DSPHST has one entry for uniaxial and 2 entries for biaxial
  and 2 entries for biaxial displacement patterns; FRCHST has only one entry.
  DSPPAT is a character variable if the displacement pattern is the same for all cycles and
  a character cell array, if the displacement pattern varies from cycle to cycle;
  the character variable identifies the path of the displacement pattern with the syntax:
  U means uniaxial and B biaxial, with the addition of V indicating a variable axial force;
  the supported patterns are:
  U1(UV1) : uniaxial displacement history in 1-direction
  U2(UV2) : uniaxial displacement history in 2-direction
  U3(UV3) : displacement history at specified ratio of values along axis 1 and 2
  B1(BV1) : circular displacement pattern starting with axis 1
  B2(BV2) : counter-clock wise clover leaf pattern
  B3(BV3) : diamond  displacement pattern
  B4(BV4) : circular displacement pattern starting with axis 2
  the optional argument TMSTR is a logical variable (true or false) to indicate whether the
  the pseudo-time needs stretching/shortening to maintain equal displacement increment
  for each displacement reversal (default = true).
  OPTIONS(NCYC) is an optional structure array with the following fields:
        .TrmpN = time interval for ramping up         the application of the axial force N
        .TrmpU = time interval for ramping up or down the application of the first displacement
        .Nsub  = time subdivision for description of the circular path
        .NRat  = ratio of axial force variation relative to constant value
        .HCyc  = true or false; true for half    cycle instead of full displacement cycle
        .QCyc  = true or false; true for quarter cycle instead of full displacement cycle

Cross-Reference Information

This function calls:

• Create_DispCyclewN generate time and value pairs for a single displacement cycle with normal force