SubRegionalization Handbook - Revision history

MeredithMoon at 21:32, 7 September 2017

2017-09-07T21:32:57Z

← Older revision		Revision as of 21:32, 7 September 2017
Line 298:		Line 298:
	It is also possible to switch between different model runs (i.e. between the national level and a sub-regional model). For instance, you have just completed a sub-regionalization that divides China into single provinces. Now, you would like to use data for the whole country as a Base Case again. To remove all sub-regions, open the window for ''Add or Delete Subregions''. Click on ''Switch Provinces'' and choose ''No State/Province'' from the right side box of Available Runs. Click ''Switch'' to restore the model to pre-sub-regionalization status.		It is also possible to switch between different model runs (i.e. between the national level and a sub-regional model). For instance, you have just completed a sub-regionalization that divides China into single provinces. Now, you would like to use data for the whole country as a Base Case again. To remove all sub-regions, open the window for ''Add or Delete Subregions''. Click on ''Switch Provinces'' and choose ''No State/Province'' from the right side box of Available Runs. Click ''Switch'' to restore the model to pre-sub-regionalization status.

	At this point you will be asked if you want to save your current configuration. It is important to select ''Yes'' in order switch back to the preferred sub-regionalization the next time you want to revert back to the sub-regional version.		At this point you will be asked if you want to save your current configuration. It is important to select ''Yes'' in order switch back to the preferred sub-regionalization the next time you want to revert back to the sub-regional version. This process only takes 5 - 10 minutes, so it is possible to switch back and forth on a regular basis.

	==== Switching Models to Process New Data ====		==== Switching Models to Process New Data ====

AltheaDitter at 19:55, 14 June 2017

2017-06-14T19:55:35Z

← Older revision		Revision as of 19:55, 14 June 2017
Line 303:		Line 303:

	To process newly imported data for the preferred sub-regionalization, the existing sub-region setup (used for switching) needs to be removed first and the model needs to be broken out again. To do this users must switch their model from the broken out version to the ''No State/Province'' version as described above. The option to delete a sub-region setup is in the same window as to add sub-regions. After the model has been switched to No State/Province select the country from the box on the right, ''Available Runs:'' and click ''Remove ''to delete the sub-region setup. Deleting a sub-region setup will remove all files created in the process of adding the sub-region setup, and the corresponding model run will no longer be available from the Switch Provinces option.		To process newly imported data for the preferred sub-regionalization, the existing sub-region setup (used for switching) needs to be removed first and the model needs to be broken out again. To do this users must switch their model from the broken out version to the ''No State/Province'' version as described above. The option to delete a sub-region setup is in the same window as to add sub-regions. After the model has been switched to No State/Province select the country from the box on the right, ''Available Runs:'' and click ''Remove ''to delete the sub-region setup. Deleting a sub-region setup will remove all files created in the process of adding the sub-region setup, and the corresponding model run will no longer be available from the Switch Provinces option.

	~~== Multiple Subregional Model Breakouts ==~~

	The option of having multiple sub-regional models broken out on a single model is available. This option was originally given to allow for IFs users the ability to compare China and India's provincial models at the same time. The large and diverse populations of India and China makes them difficult to understand in aggregate and the ability to compare these large units subnationally is desirable.

	The total number of sub-regional units that can be broken out on a single model is limited by ''MaxReg. ''As of version 7.28, the maximum number of country units possible is 255. This 255 limit is necessary to break out Uganda's 115 sub-regions with 185 countries. The limit allows for users to break out any two of the currently available sub-regional models (China, India, South Africa, and the United States) simultaneously, with the exception of Uganda.

	To break out two sub-regional models simultaneously break out one of the desired sub-regional models following the ''Add and Delete Sub-Regions'' protocol that is described above. After the model is run, reopen ''Add and Delete Sub-Regions'' and select the second desired sub-regional model while the first model is broken out. Then click on ''Add''. This will generate the following prompt:

	~~Click on ''Okay''. ~~

	~~=== Increasing the MaxReg ===~~

	To allow for the breakout of three subnational model in IFs, the maximum number of regions allowed in the model must be increased to the desired upper limit in a development version of the model. To change the maximum number of regions users must open ''ifsInit.mdb'''''<i>,</i>''' which is found in ''Local Disc C: '''> '''U''sers > ''Public ''> ''IFs > DATA ''> ''ProvinceSwitch >''' '''''<i>Base</i>'''.''' In'' ifsInit.mdb'' select the table'' LoadFull''. The variable ''MaxReg'' in the table controls the total number of regions that are allowed in IFs. The standard model (without subregions) has 186 countries, but each subregional model subtracts one country and adds the total number of provinces for that country. For instance, the US model has 51 provincial units and thus there needs to be a minimum ''MaxReg'' of 236 (186-1+51=236). The ''MaxReg'' must be increased by more than the minimum number of sub-regions needed. For instance, if 305 sub-regions are needed, increase the ''MaxReg ''310.''' '''

	~~[[File:IfsInitMaxReg.png\|RTENOTITLE]]~~

	IFsInit.mdb is also located in the IFs version folder in the shares drive ''IFsX(\\shares.du.edu\Research\Pardee\Research Common)'', the load full table in this folder also needs the ''MaxReg'' increased to the same value.

	After the maximum number of regions has been increased, the script on the development machine must be run by clicking on the ''Prepare IFs Dev'' icon on the desktop. This will open a window that shows develpment versions 1 through 10, select the appropriate version and click okay. A window titled ''RegSvr32'' will pop-up and click ''Okay''.

	the user must rebuild the Common. Rebuilding the common is how variable updates are read into the model. Rebuilding the common is done through ''Extended Features ''> ''Rebuild Common ''> ''Rebuild (variable change made offline).''''' '''This will bring up the following prompt:

	~~[[File:Rebuildcommon.png\|RTENOTITLE]]~~

	~~Select ''Rebuild Common'''''. '''~~

	= Appendix =		= Appendix =

AltheaDitter at 19:54, 14 June 2017

2017-06-14T19:54:48Z

← Older revision		Revision as of 19:54, 14 June 2017
Line 303:		Line 303:

	To process newly imported data for the preferred sub-regionalization, the existing sub-region setup (used for switching) needs to be removed first and the model needs to be broken out again. To do this users must switch their model from the broken out version to the ''No State/Province'' version as described above. The option to delete a sub-region setup is in the same window as to add sub-regions. After the model has been switched to No State/Province select the country from the box on the right, ''Available Runs:'' and click ''Remove ''to delete the sub-region setup. Deleting a sub-region setup will remove all files created in the process of adding the sub-region setup, and the corresponding model run will no longer be available from the Switch Provinces option.		To process newly imported data for the preferred sub-regionalization, the existing sub-region setup (used for switching) needs to be removed first and the model needs to be broken out again. To do this users must switch their model from the broken out version to the ''No State/Province'' version as described above. The option to delete a sub-region setup is in the same window as to add sub-regions. After the model has been switched to No State/Province select the country from the box on the right, ''Available Runs:'' and click ''Remove ''to delete the sub-region setup. Deleting a sub-region setup will remove all files created in the process of adding the sub-region setup, and the corresponding model run will no longer be available from the Switch Provinces option.

	~~==== Saving and Switching Between Different Model Versions ====~~

	Users may want to save different versions of their model to compare. For instance, one version is broken out with population data from source A and the other version is using population data from source B. To save the two versions, users must break out the first version and rebuild the base. After the model is broken out, open the window for ''Add or Delete Subregions'' and select ''Save Current Setup''. This will cause a prompt to pop up saying ''Setup for XXX Already Exists. Do you want to override it?'' select yes.

	~~[[File:2017-06-06.png\|900px\|2017-06-06.png]]~~

	== Multiple Subregional Model Breakouts ==		== Multiple Subregional Model Breakouts ==

AltheaDitter at 19:51, 14 June 2017

2017-06-14T19:51:15Z

← Older revision		Revision as of 19:51, 14 June 2017
Line 20:		Line 20:
	*Select the country that is intended to be subregionalized and click ''OK''		*Select the country that is intended to be subregionalized and click ''OK''

	This does a couple things. First, it creates a new ''IFsHistSeries.mdb'' for the country you selected in ''C:\Users\Public\IFs\DATA''. The file will include tables for the 4 essential series and a datadict. It also adds the country to the ''Provinces'' tables in ''Provinces.mdb''.		This does a couple of things. First, it creates a new ''IFsHistSeries.mdb'' for the country you selected in ''C:\Users\Public\IFs\DATA''. The file will include tables for the 4 essential series and a datadict. It also adds the country to the ''Provinces'' tables in ''Provinces.mdb''.

	The entire process of sub-regionalization affects five files:''IFs.mdb, IFsHistSeries.mdb, IFsCoVatra.mdb, IFsCoVatraSeries.mdb,''and ''IFsWVSCohort.mdb''. For each of the files, the process looks in the ''IFs\Data'' folder for an equivalent file with the name of the country at the end — again, ''IFsHistSeriesChina.mdb'' is an example — then creates a copy in the''IFs\Runfiles'' directory. Modification is done in the copies on the ''\Runfiles ''directory as well to the original files in the ''\Data'' directory. Data for individual sub-regional units and the country as a whole are preserved, and can be copied back and forth between ''\Data'' and ''\Runfiles'' directories. This allows the user to switch between model runs with different sub-regionalizations, and reset everything to the starting point without any states/provinces/departments sub-regionalized.		The entire process of sub-regionalization affects five files:''IFs.mdb, IFsHistSeries.mdb, IFsCoVatra.mdb, IFsCoVatraSeries.mdb,''and ''IFsWVSCohort.mdb''. For each of the files, the process looks in the ''IFs\Data'' folder for an equivalent file with the name of the country at the end — again, ''IFsHistSeriesChina.mdb'' is an example — then creates a copy in the''IFs\Runfiles'' directory. Modification is done in the copies on the ''\Runfiles ''directory as well to the original files in the ''\Data'' directory. Data for individual sub-regional units and the country as a whole are preserved, and can be copied back and forth between ''\Data'' and ''\Runfiles'' directories. This allows the user to switch between model runs with different sub-regionalizations, and reset everything to the starting point without any states/provinces/departments sub-regionalized.

AltheaDitter at 18:21, 6 June 2017

2017-06-06T18:21:58Z

← Older revision		Revision as of 18:21, 6 June 2017
Line 308:		Line 308:
	Users may want to save different versions of their model to compare. For instance, one version is broken out with population data from source A and the other version is using population data from source B. To save the two versions, users must break out the first version and rebuild the base. After the model is broken out, open the window for ''Add or Delete Subregions'' and select ''Save Current Setup''. This will cause a prompt to pop up saying ''Setup for XXX Already Exists. Do you want to override it?'' select yes.		Users may want to save different versions of their model to compare. For instance, one version is broken out with population data from source A and the other version is using population data from source B. To save the two versions, users must break out the first version and rebuild the base. After the model is broken out, open the window for ''Add or Delete Subregions'' and select ''Save Current Setup''. This will cause a prompt to pop up saying ''Setup for XXX Already Exists. Do you want to override it?'' select yes.

	[[File:2017-06-06.png\|900px]]		[[File:2017-06-06.png\|900px\|2017-06-06.png]]

	== Multiple Subregional Model Breakouts ==		== Multiple Subregional Model Breakouts ==

AltheaDitter at 18:03, 6 June 2017

2017-06-06T18:03:43Z

← Older revision		Revision as of 18:03, 6 June 2017
Line 324:		Line 324:
	To allow for the breakout of three subnational model in IFs, the maximum number of regions allowed in the model must be increased to the desired upper limit in a development version of the model. To change the maximum number of regions users must open ''ifsInit.mdb'''''<i>,</i>''' which is found in ''Local Disc C: '''> '''U''sers > ''Public ''> ''IFs > DATA ''> ''ProvinceSwitch >''' '''''<i>Base</i>'''.''' In'' ifsInit.mdb'' select the table'' LoadFull''. The variable ''MaxReg'' in the table controls the total number of regions that are allowed in IFs. The standard model (without subregions) has 186 countries, but each subregional model subtracts one country and adds the total number of provinces for that country. For instance, the US model has 51 provincial units and thus there needs to be a minimum ''MaxReg'' of 236 (186-1+51=236). The ''MaxReg'' must be increased by more than the minimum number of sub-regions needed. For instance, if 305 sub-regions are needed, increase the ''MaxReg ''310.''' '''		To allow for the breakout of three subnational model in IFs, the maximum number of regions allowed in the model must be increased to the desired upper limit in a development version of the model. To change the maximum number of regions users must open ''ifsInit.mdb'''''<i>,</i>''' which is found in ''Local Disc C: '''> '''U''sers > ''Public ''> ''IFs > DATA ''> ''ProvinceSwitch >''' '''''<i>Base</i>'''.''' In'' ifsInit.mdb'' select the table'' LoadFull''. The variable ''MaxReg'' in the table controls the total number of regions that are allowed in IFs. The standard model (without subregions) has 186 countries, but each subregional model subtracts one country and adds the total number of provinces for that country. For instance, the US model has 51 provincial units and thus there needs to be a minimum ''MaxReg'' of 236 (186-1+51=236). The ''MaxReg'' must be increased by more than the minimum number of sub-regions needed. For instance, if 305 sub-regions are needed, increase the ''MaxReg ''310.''' '''

	[[File:IfsInitMaxReg.png]]		[[File:IfsInitMaxReg.png\|RTENOTITLE]]

	IFsInit.mdb is also located in the IFs version folder in the shares drive ''IFsX(\\shares.du.edu\Research\Pardee\Research Common)'', the load full table in this folder also needs the ''MaxReg'' increased to the same value.		IFsInit.mdb is also located in the IFs version folder in the shares drive ''IFsX(\\shares.du.edu\Research\Pardee\Research Common)'', the load full table in this folder also needs the ''MaxReg'' increased to the same value.

AltheaDitter at 18:02, 6 June 2017

2017-06-06T18:02:45Z

← Older revision		Revision as of 18:02, 6 June 2017
Line 307:		Line 307:

	Users may want to save different versions of their model to compare. For instance, one version is broken out with population data from source A and the other version is using population data from source B. To save the two versions, users must break out the first version and rebuild the base. After the model is broken out, open the window for ''Add or Delete Subregions'' and select ''Save Current Setup''. This will cause a prompt to pop up saying ''Setup for XXX Already Exists. Do you want to override it?'' select yes.		Users may want to save different versions of their model to compare. For instance, one version is broken out with population data from source A and the other version is using population data from source B. To save the two versions, users must break out the first version and rebuild the base. After the model is broken out, open the window for ''Add or Delete Subregions'' and select ''Save Current Setup''. This will cause a prompt to pop up saying ''Setup for XXX Already Exists. Do you want to override it?'' select yes.

			[[File:2017-06-06.png\|900px]]

	== Multiple Subregional Model Breakouts ==		== Multiple Subregional Model Breakouts ==

AltheaDitter at 18:00, 6 June 2017

2017-06-06T18:00:46Z

← Older revision		Revision as of 18:00, 6 June 2017
Line 293:		Line 293:

	Select ''OK'' to this message and then click ''Run Successful – Click to Continue''.		Select ''OK'' to this message and then click ''Run Successful – Click to Continue''.

			=== Switching Models ===

	It is also possible to switch between different model runs (i.e. between the national level and a sub-regional model). For instance, you have just completed a sub-regionalization that divides China into single provinces. Now, you would like to use data for the whole country as a Base Case again. To remove all sub-regions, open the window for ''Add or Delete Subregions''. Click on ''Switch Provinces'' and choose ''No State/Province'' from the right side box of Available Runs. Click ''Switch'' to restore the model to pre-sub-regionalization status.		It is also possible to switch between different model runs (i.e. between the national level and a sub-regional model). For instance, you have just completed a sub-regionalization that divides China into single provinces. Now, you would like to use data for the whole country as a Base Case again. To remove all sub-regions, open the window for ''Add or Delete Subregions''. Click on ''Switch Provinces'' and choose ''No State/Province'' from the right side box of Available Runs. Click ''Switch'' to restore the model to pre-sub-regionalization status.
Line 298:		Line 300:
	At this point you will be asked if you want to save your current configuration. It is important to select ''Yes'' in order switch back to the preferred sub-regionalization the next time you want to revert back to the sub-regional version.		At this point you will be asked if you want to save your current configuration. It is important to select ''Yes'' in order switch back to the preferred sub-regionalization the next time you want to revert back to the sub-regional version.

	To process newly imported data for the preferred sub-regionalization, the existing sub-region setup (used for switching) needs to be ~~deleted~~ first. The option to delete a sub-region setup is in the same window as to add sub-regions. ~~Select a~~ country from the box in the ~~bottom (countries with sub-regions in the system)~~ and click ''~~Delete~~'' to delete the sub-region setup. Deleting a sub-region setup will remove all files created in the process of adding the sub-region setup, and the corresponding model run will no longer be available from the Switch Provinces option.		==== Switching Models to Process New Data ====

			To process newly imported data for the preferred sub-regionalization, the existing sub-region setup (used for switching) needs to be removed first and the model needs to be broken out again. To do this users must switch their model from the broken out version to the ''No State/Province'' version as described above. The option to delete a sub-region setup is in the same window as to add sub-regions. After the model has been switched to No State/Province select the country from the box on the right, ''Available Runs:'' and click ''Remove ''to delete the sub-region setup. Deleting a sub-region setup will remove all files created in the process of adding the sub-region setup, and the corresponding model run will no longer be available from the Switch Provinces option.

			==== Saving and Switching Between Different Model Versions ====

			Users may want to save different versions of their model to compare. For instance, one version is broken out with population data from source A and the other version is using population data from source B. To save the two versions, users must break out the first version and rebuild the base. After the model is broken out, open the window for ''Add or Delete Subregions'' and select ''Save Current Setup''. This will cause a prompt to pop up saying ''Setup for XXX Already Exists. Do you want to override it?'' select yes.

	== Multiple Subregional Model Breakouts ==		== Multiple Subregional Model Breakouts ==

AltheaDitter at 21:16, 31 May 2017

2017-05-31T21:16:06Z

← Older revision		Revision as of 21:16, 31 May 2017
Line 312:		Line 312:
	=== Increasing the MaxReg ===		=== Increasing the MaxReg ===

	To allow for the breakout of three subnational model in IFs, the maximum number of regions allowed in the model must be increased to the desired upper limit in a development version of the model. To change the maximum number of regions users must open ''ifsInit.mdb'''''<i>,</i>''' which is found in ''Local Disc C: '''> '''U''sers > ''Public ''> ''IFs > DATA ''> ''ProvinceSwitch >''' '''''<i>Base</i>'''.''' In'' ifsInit.mdb'' select the table'' LoadFull''. The variable ''MaxReg'' in the table controls the total number of regions that are allowed in IFs.		To allow for the breakout of three subnational model in IFs, the maximum number of regions allowed in the model must be increased to the desired upper limit in a development version of the model. To change the maximum number of regions users must open ''ifsInit.mdb'''''<i>,</i>''' which is found in ''Local Disc C: '''> '''U''sers > ''Public ''> ''IFs > DATA ''> ''ProvinceSwitch >''' '''''<i>Base</i>'''.''' In'' ifsInit.mdb'' select the table'' LoadFull''. The variable ''MaxReg'' in the table controls the total number of regions that are allowed in IFs. The standard model (without subregions) has 186 countries, but each subregional model subtracts one country and adds the total number of provinces for that country. For instance, the US model has 51 provincial units and thus there needs to be a minimum ''MaxReg'' of 236 (186-1+51=236). The ''MaxReg'' must be increased by more than the minimum number of sub-regions needed. For instance, if 305 sub-regions are needed, increase the ''MaxReg ''310.''' '''

	~~The standard model (without subregions) has 186 countries, but each subregional model subtracts one country and adds the total number of provinces for that country~~. For instance, the US model has 51 provincial units and thus there needs to be a minimum ''MaxReg'' of 236 (186-1+51=236). The ''MaxReg'' must be increased by more than the minimum number of sub-regions needed. For instance, if 305 sub-regions are needed, increase the ''MaxReg ''310.''' '''		[[File:IfsInitMaxReg.png]]

	After the maximum number of regions has been increased, the user must rebuild the Common. Rebuilding the common is how variable updates are read into the model. Rebuilding the common is done through ''Extended Features ''> ''Rebuild Common ''> ''Rebuild (variable change made offline).''''' '''This will bring up the following prompt:		IFsInit.mdb is also located in the IFs version folder in the shares drive ''IFsX(\\shares.du.edu\Research\Pardee\Research Common)'', the load full table in this folder also needs the ''MaxReg'' increased to the same value.

			After the maximum number of regions has been increased, the script on the development machine must be run by clicking on the ''Prepare IFs Dev'' icon on the desktop. This will open a window that shows develpment versions 1 through 10, select the appropriate version and click okay. A window titled ''RegSvr32'' will pop-up and click ''Okay''.

			the user must rebuild the Common. Rebuilding the common is how variable updates are read into the model. Rebuilding the common is done through ''Extended Features ''> ''Rebuild Common ''> ''Rebuild (variable change made offline).''''' '''This will bring up the following prompt:

	[[File:Rebuildcommon.png\|RTENOTITLE]]		[[File:Rebuildcommon.png\|RTENOTITLE]]

AltheaDitter at 20:51, 31 May 2017

2017-05-31T20:51:21Z

← Older revision		Revision as of 20:51, 31 May 2017
Line 312:		Line 312:
	=== Increasing the MaxReg ===		=== Increasing the MaxReg ===

	To allow for the breakout of three subnational model in IFs, the maximum number of regions allowed in the model must be increased to the desired upper limit in a development version of the model. To change the maximum number of regions users must open ''ifsInit.mdb'''''<i>,</i>''' which is found in ''Local Disc C: '''> '''U''sers > ''Public ''> ''IFs > DATA ''> ''ProvinceSwitch >''' '''''<i>Base</i>'''.''' In'' ifsInit.mdb'' select the table'' LoadFull''. The variable ''MaxReg'' in the table controls the total number of regions that are allowed in IFs. The standard model (without subregions) has 186 countries, but each subregional model subtracts one country and adds the total number of provinces for that country. For instance, the US model has 51 provincial units and thus there needs to be a minimum ''MaxReg'' of 236 (186-1+51=236). The ''MaxReg'' must be increased by more than the minimum number of sub-regions needed. For instance, if 305 sub-regions are needed, increase the ''MaxReg ''310.''' '''		To allow for the breakout of three subnational model in IFs, the maximum number of regions allowed in the model must be increased to the desired upper limit in a development version of the model. To change the maximum number of regions users must open ''ifsInit.mdb'''''<i>,</i>''' which is found in ''Local Disc C: '''> '''U''sers > ''Public ''> ''IFs > DATA ''> ''ProvinceSwitch >''' '''''<i>Base</i>'''.''' In'' ifsInit.mdb'' select the table'' LoadFull''. The variable ''MaxReg'' in the table controls the total number of regions that are allowed in IFs.

			The standard model (without subregions) has 186 countries, but each subregional model subtracts one country and adds the total number of provinces for that country. For instance, the US model has 51 provincial units and thus there needs to be a minimum ''MaxReg'' of 236 (186-1+51=236). The ''MaxReg'' must be increased by more than the minimum number of sub-regions needed. For instance, if 305 sub-regions are needed, increase the ''MaxReg ''310.''' '''

	After the maximum number of regions has been increased, the user must rebuild the Common. Rebuilding the common is how variable updates are read into the model. Rebuilding the common is done through ''Extended Features ''> ''Rebuild Common ''> ''Rebuild (variable change made offline).''''' '''This will bring up the following prompt:		After the maximum number of regions has been increased, the user must rebuild the Common. Rebuilding the common is how variable updates are read into the model. Rebuilding the common is done through ''Extended Features ''> ''Rebuild Common ''> ''Rebuild (variable change made offline).''''' '''This will bring up the following prompt: