SUBROUTINE TYPE200 (TIME,XIN,OUT,T,DTDT,PAR,INFO,ICNTRL,*) !************************************************************************ ! Object: Seasonal Switch ! Simulation Studio Model: Type200 ! ! Author: Ethan Lust ! Editor: ! Date: April 23, 2008 last modified: April 23, 2008 ! ! ! *** ! *** Model Parameters ! *** ! setpoint C [-Inf;+Inf] ! deadband C [0;+Inf] ! *** ! *** Model Inputs ! *** ! input_signal - [-Inf;+Inf] ! T_space ! [-Inf;+Inf] ! *** ! *** Model Outputs ! *** ! output_signal - [-Inf;+Inf] ! switch - [0;1] ! *** ! *** Model Derivatives ! *** ! (Comments and routine interface generated by TRNSYS Studio) !************************************************************************ ! TRNSYS acess functions (allow to acess TIME etc.) USE TrnsysConstants USE TrnsysFunctions !----------------------------------------------------------------------------------------------------------------------- ! REQUIRED BY THE MULTI-DLL VERSION OF TRNSYS !DEC$ATTRIBUTES DLLEXPORT :: TYPE200 !SET THE CORRECT TYPE NUMBER HERE !----------------------------------------------------------------------------------------------------------------------- !----------------------------------------------------------------------------------------------------------------------- ! TRNSYS DECLARATIONS IMPLICIT NONE !REQUIRES THE USER TO DEFINE ALL VARIABLES BEFORE USING THEM DOUBLE PRECISION XIN !THE ARRAY FROM WHICH THE INPUTS TO THIS TYPE WILL BE RETRIEVED DOUBLE PRECISION OUT !THE ARRAY WHICH WILL BE USED TO STORE THE OUTPUTS FROM THIS TYPE DOUBLE PRECISION TIME !THE CURRENT SIMULATION TIME - YOU MAY USE THIS VARIABLE BUT DO NOT SET IT! DOUBLE PRECISION PAR !THE ARRAY FROM WHICH THE PARAMETERS FOR THIS TYPE WILL BE RETRIEVED DOUBLE PRECISION STORED !THE STORAGE ARRAY FOR HOLDING VARIABLES FROM TIMESTEP TO TIMESTEP DOUBLE PRECISION T !AN ARRAY CONTAINING THE RESULTS FROM THE DIFFERENTIAL EQUATION SOLVER DOUBLE PRECISION DTDT !AN ARRAY CONTAINING THE DERIVATIVES TO BE PASSED TO THE DIFF.EQ. SOLVER INTEGER*4 INFO(15) !THE INFO ARRAY STORES AND PASSES VALUABLE INFORMATION TO AND FROM THIS TYPE INTEGER*4 NP,NI,NOUT,ND !VARIABLES FOR THE MAXIMUM NUMBER OF PARAMETERS,INPUTS,OUTPUTS AND DERIVATIVES INTEGER*4 NPAR,NIN,NDER !VARIABLES FOR THE CORRECT NUMBER OF PARAMETERS,INPUTS,OUTPUTS AND DERIVATIVES INTEGER*4 IUNIT,ITYPE !THE UNIT NUMBER AND TYPE NUMBER FOR THIS COMPONENT INTEGER*4 ICNTRL !AN ARRAY FOR HOLDING VALUES OF CONTROL FUNCTIONS WITH THE NEW SOLVER INTEGER*4 NSTORED !THE NUMBER OF VARIABLES THAT WILL BE PASSED INTO AND OUT OF STORAGE CHARACTER*3 OCHECK !AN ARRAY TO BE FILLED WITH THE CORRECT VARIABLE TYPES FOR THE OUTPUTS CHARACTER*3 YCHECK !AN ARRAY TO BE FILLED WITH THE CORRECT VARIABLE TYPES FOR THE INPUTS !----------------------------------------------------------------------------------------------------------------------- !----------------------------------------------------------------------------------------------------------------------- ! USER DECLARATIONS - SET THE MAXIMUM NUMBER OF PARAMETERS (NP), INPUTS (NI), ! OUTPUTS (NOUT), AND DERIVATIVES (ND) THAT MAY BE SUPPLIED FOR THIS TYPE PARAMETER (NP=2,NI=3,NOUT=2,ND=0,NSTORED=1) !----------------------------------------------------------------------------------------------------------------------- !----------------------------------------------------------------------------------------------------------------------- ! REQUIRED TRNSYS DIMENSIONS DIMENSION XIN(NI),OUT(NOUT),PAR(NP),YCHECK(NI),OCHECK(NOUT), 1 STORED(NSTORED),T(ND),DTDT(ND) INTEGER NITEMS !----------------------------------------------------------------------------------------------------------------------- !----------------------------------------------------------------------------------------------------------------------- ! ADD DECLARATIONS AND DEFINITIONS FOR THE USER-VARIABLES HERE ! PARAMETERS DOUBLE PRECISION setpoint DOUBLE PRECISION deadband ! INPUTS DOUBLE PRECISION input_signal DOUBLE PRECISION T_space ! OUTPUTS DOUBLE PRECISION output_signal DOUBLE PRECISION switch ! LOCAL VARIABLE DOUBLE PRECISION error !----------------------------------------------------------------------------------------------------------------------- ! READ IN THE VALUES OF THE PARAMETERS IN SEQUENTIAL ORDER setpoint=PAR(1) deadband=PAR(2) !----------------------------------------------------------------------------------------------------------------------- ! RETRIEVE THE CURRENT VALUES OF THE INPUTS TO THIS MODEL FROM THE XIN ARRAY IN SEQUENTIAL ORDER input_signal=XIN(1) T_space = XIN(2) switch = XIN(3) IUNIT=INFO(1) ITYPE=INFO(2) !----------------------------------------------------------------------------------------------------------------------- ! SET THE VERSION INFORMATION FOR TRNSYS IF(INFO(7).EQ.-2) THEN INFO(12)=16 RETURN 1 ENDIF !----------------------------------------------------------------------------------------------------------------------- !----------------------------------------------------------------------------------------------------------------------- ! DO ALL THE VERY LAST CALL OF THE SIMULATION MANIPULATIONS HERE IF (INFO(8).EQ.-1) THEN RETURN 1 ENDIF !----------------------------------------------------------------------------------------------------------------------- !----------------------------------------------------------------------------------------------------------------------- ! PERFORM ANY 'AFTER-ITERATION' MANIPULATIONS THAT ARE REQUIRED HERE ! e.g. save variables to storage array for the next timestep ! IF (INFO(13).GT.0) THEN ! NITEMS=1 ! STORED(1)= switch ! CALL setStorageVars(STORED,NITEMS,INFO) ! RETURN 1 ! ENDIF ! !----------------------------------------------------------------------------------------------------------------------- !----------------------------------------------------------------------------------------------------------------------- ! DO ALL THE VERY FIRST CALL OF THE SIMULATION MANIPULATIONS HERE IF (INFO(7).EQ.-1) THEN ! SET SOME INFO ARRAY VARIABLES TO TELL THE TRNSYS ENGINE HOW THIS TYPE IS TO WORK INFO(6)=NOUT INFO(9)=1 INFO(10)=0 !STORAGE FOR VERSION 16 HAS BEEN CHANGED ! SET THE REQUIRED NUMBER OF INPUTS, PARAMETERS AND DERIVATIVES THAT THE USER SHOULD SUPPLY IN THE INPUT FILE ! IN SOME CASES, THE NUMBER OF VARIABLES MAY DEPEND ON THE VALUE OF PARAMETERS TO THIS MODEL.... NIN=NI NPAR=NP NDER=ND ! CALL THE TYPE CHECK SUBROUTINE TO COMPARE WHAT THIS COMPONENT REQUIRES TO WHAT IS SUPPLIED IN ! THE TRNSYS INPUT FILE CALL TYPECK(1,INFO,NIN,NPAR,NDER) ! SET THE NUMBER OF STORAGE SPOTS NEEDED FOR THIS COMPONENT ! NITEMS=1 ! CALL setStorageSize(NITEMS,INFO) ! RETURN TO THE CALLING PROGRAM RETURN 1 ENDIF !----------------------------------------------------------------------------------------------------------------------- !----------------------------------------------------------------------------------------------------------------------- ! DO ALL OF THE INITIAL TIMESTEP MANIPULATIONS HERE - THERE ARE NO ITERATIONS AT THE INTIAL TIME IF (TIME .LT. (getSimulationStartTime() + . getSimulationTimeStep()/2.D0)) THEN ! SET THE UNIT NUMBER FOR FUTURE CALLS IUNIT=INFO(1) ITYPE=INFO(2) ! CHECK THE PARAMETERS FOR PROBLEMS AND RETURN FROM THE SUBROUTINE IF AN ERROR IS FOUND ! IF(...) CALL TYPECK(-4,INFO,0,"BAD PARAMETER #",0) ! PERFORM ANY REQUIRED CALCULATIONS TO SET THE INITIAL VALUES OF THE OUTPUTS HERE ! output_signal OUT(1)=0 ! switch ! OUT(2)=0 ! PERFORM ANY REQUIRED CALCULATIONS TO SET THE INITIAL STORAGE VARIABLES HERE ! NITEMS=1 ! STORED(1)= 0 ! PUT THE STORED ARRAY IN THE GLOBAL STORED ARRAY ! CALL setStorageVars(STORED,NITEMS,INFO) ! RETURN TO THE CALLING PROGRAM RETURN 1 ENDIF !----------------------------------------------------------------------------------------------------------------------- !----------------------------------------------------------------------------------------------------------------------- ! *** ITS AN ITERATIVE CALL TO THIS COMPONENT *** !----------------------------------------------------------------------------------------------------------------------- !----------------------------------------------------------------------------------------------------------------------- ! RETRIEVE THE VALUES IN THE STORAGE ARRAY FOR THIS ITERATION ! NITEMS= 1 ! CALL getStorageVars(STORED,NITEMS,INFO) ! STORED(1)= switch !----------------------------------------------------------------------------------------------------------------------- !----------------------------------------------------------------------------------------------------------------------- ! CHECK THE INPUTS FOR PROBLEMS ! IF(...) CALL TYPECK(-3,INFO,'BAD INPUT #',0,0) ! IF(IERROR.GT.0) RETURN 1 !----------------------------------------------------------------------------------------------------------------------- !----------------------------------------------------------------------------------------------------------------------- ! *** PERFORM ALL THE CALCULATION HERE FOR THIS MODEL. *** !----------------------------------------------------------------------------------------------------------------------- input_signal = abs(input_signal) error = setpoint - T_space if (switch .EQ. 0D0) then if (error .LE. -deadband) then switch = 1D0 !Turns A/C on and heat off end if else if (switch .EQ. 1D0) then if (error .GE. deadband) then switch = 0D0 !Turns heat on and A/C off end if end if if (switch .EQ. 0D0) then if (error .GE. 0) then output_signal = input_signal else if (error .LT. 0) then output_signal = 0 end if else if (switch .EQ. 1D0) then if (error .LE. 0) then output_signal = -input_signal else if (error .GT. 0) then output_signal = 0 end if end if !----------------------------------------------------------------------------------------------------------------------- !----------------------------------------------------------------------------------------------------------------------- !----------------------------------------------------------------------------------------------------------------------- ! SET THE STORAGE ARRAY AT THE END OF THIS ITERATION IF NECESSARY ! NITEMS= 1 ! STORED(1)= switch ! CALL setStorageVars(STORED,NITEMS,INFO) !----------------------------------------------------------------------------------------------------------------------- !----------------------------------------------------------------------------------------------------------------------- ! REPORT ANY PROBLEMS THAT HAVE BEEN FOUND USING CALLS LIKE THIS: ! CALL MESSAGES(-1,'put your message here','MESSAGE',IUNIT,ITYPE) ! CALL MESSAGES(-1,'put your message here','WARNING',IUNIT,ITYPE) ! CALL MESSAGES(-1,'put your message here','SEVERE',IUNIT,ITYPE) ! CALL MESSAGES(-1,'put your message here','FATAL',IUNIT,ITYPE) !----------------------------------------------------------------------------------------------------------------------- !----------------------------------------------------------------------------------------------------------------------- ! SET THE OUTPUTS FROM THIS MODEL IN SEQUENTIAL ORDER AND GET OUT ! output_signal OUT(1) = output_signal ! switch OUT(2) = switch !----------------------------------------------------------------------------------------------------------------------- ! EVERYTHING IS DONE - RETURN FROM THIS SUBROUTINE AND MOVE ON RETURN 1 END !-----------------------------------------------------------------------------------------------------------------------