constrain and unconstrain deprecation

Author: cadenmyers13

docs/examples/coreshellnp.py

@@ -91,14 +91,14 @@ def makeRecipe(stru1, stru2, datname):
     # diameter to twice the shell radius.
     recipe.add_variable(contribution.radius, 15)
     recipe.add_variable(contribution.thickness, 11)
-    recipe.constrain(contribution.psize, "2 * radius")
+    recipe.constrain_parameter(contribution.psize, "2 * radius")
 
     # Configure the fit variables
     # Start by configuring the scale factor and resolution factors.
     # We want the sum of the phase scale factors to be 1.
     recipe.create_new_variable("scale_CdS", 0.7)
-    recipe.constrain(generator_cds.scale, "scale_CdS")
-    recipe.constrain(generator_zns.scale, "1 - scale_CdS")
+    recipe.constrain_parameter(generator_cds.scale, "scale_CdS")
+    recipe.constrain_parameter(generator_zns.scale, "1 - scale_CdS")
     # We also want the resolution factor to be the same on each.
 
     # Vary the global scale as well.
@@ -117,7 +117,7 @@ def makeRecipe(stru1, stru2, datname):
     )
     # Since we know these have stacking disorder, constrain the B33 adps for
     # each atom type.
-    recipe.constrain("B33_1_cds", "B33_0_cds")
+    recipe.constrain_parameter("B33_1_cds", "B33_0_cds")
     recipe.add_variable(generator_cds.delta2, name="delta2_cds", value=5)
 
     phase_zns = generator_zns.phase
@@ -128,7 +128,7 @@ def makeRecipe(stru1, stru2, datname):
     recipe.add_variable(
         phase_zns.sgpars.xyzpars.z_1, name="z_1_zns", tag="xyz"
     )
-    recipe.constrain("B33_1_zns", "B33_0_zns")
+    recipe.constrain_parameter("B33_1_zns", "B33_0_zns")
     recipe.add_variable(generator_zns.delta2, name="delta2_zns", value=2.5)
 
     # Give the recipe away so it can be used!

docs/examples/crystalpdfall.py

@@ -113,24 +113,24 @@ def makeRecipe(
     for par in phase_ni.sgpars:
         recipe.add_variable(par, name=par.name + "_ni")
     delta2_ni = recipe.create_new_variable("delta2_ni", 2.5)
-    recipe.constrain(xgenerator_ni.delta2, delta2_ni)
-    recipe.constrain(ngenerator_ni.delta2, delta2_ni)
-    recipe.constrain(xgenerator_sini_ni.delta2, delta2_ni)
+    recipe.constrain_parameter(xgenerator_ni.delta2, delta2_ni)
+    recipe.constrain_parameter(ngenerator_ni.delta2, delta2_ni)
+    recipe.constrain_parameter(xgenerator_sini_ni.delta2, delta2_ni)
 
     for par in phase_si.sgpars:
         recipe.add_variable(par, name=par.name + "_si")
     delta2_si = recipe.create_new_variable("delta2_si", 2.5)
-    recipe.constrain(xgenerator_si.delta2, delta2_si)
-    recipe.constrain(xgenerator_sini_si.delta2, delta2_si)
+    recipe.constrain_parameter(xgenerator_si.delta2, delta2_si)
+    recipe.constrain_parameter(xgenerator_sini_si.delta2, delta2_si)
 
     # Now the experimental parameters
     recipe.add_variable(xgenerator_ni.scale, name="xscale_ni")
     recipe.add_variable(xgenerator_si.scale, name="xscale_si")
     recipe.add_variable(ngenerator_ni.scale, name="nscale_ni")
     recipe.add_variable(xcontribution_sini.scale, 1.0, "xscale_sini")
     recipe.create_new_variable("pscale_sini_ni", 0.8)
-    recipe.constrain(xgenerator_sini_ni.scale, "pscale_sini_ni")
-    recipe.constrain(xgenerator_sini_si.scale, "1 - pscale_sini_ni")
+    recipe.constrain_parameter(xgenerator_sini_ni.scale, "pscale_sini_ni")
+    recipe.constrain_parameter(xgenerator_sini_si.scale, "1 - pscale_sini_ni")
 
     # The qdamp parameters are too correlated to vary so we fix them based on
     # previous measurements.

docs/examples/crystalpdftwodata.py

@@ -121,8 +121,8 @@ def makeRecipe(ciffile, xdatname, ndatname):
     # delta2 is a non-structual material property. Thus, we constrain together
     # delta2 Parameter from each PDFGenerator.
     delta2 = recipe.create_new_variable("delta2", 2)
-    recipe.constrain(xgenerator.delta2, delta2)
-    recipe.constrain(ngenerator.delta2, delta2)
+    recipe.constrain_parameter(xgenerator.delta2, delta2)
+    recipe.constrain_parameter(ngenerator.delta2, delta2)
 
     # We only need to constrain phase properties once since there is a single
     # ObjCrystCrystalParSet for the Crystal.

docs/examples/crystalpdftwophase.py

@@ -90,12 +90,12 @@ def makeRecipe(niciffile, siciffile, datname):
     # Start by configuring the scale factor and resolution factors.
     # We want the sum of the phase scale factors to be 1.
     recipe.create_new_variable("scale_ni", 0.1)
-    recipe.constrain(generator_ni.scale, "scale_ni")
-    recipe.constrain(generator_si.scale, "1 - scale_ni")
+    recipe.constrain_parameter(generator_ni.scale, "scale_ni")
+    recipe.constrain_parameter(generator_si.scale, "1 - scale_ni")
     # We also want the resolution factor to be the same on each.
     recipe.create_new_variable("qdamp", 0.03)
-    recipe.constrain(generator_ni.qdamp, "qdamp")
-    recipe.constrain(generator_si.qdamp, "qdamp")
+    recipe.constrain_parameter(generator_ni.qdamp, "qdamp")
+    recipe.constrain_parameter(generator_si.qdamp, "qdamp")
 
     # Vary the global scale as well.
     recipe.add_variable(contribution.scale, 1)

docs/examples/debyemodelII.py

@@ -89,8 +89,8 @@ def makeRecipeII():
     # We create a new Variable and use the recipe's "constrain" method to
     # associate the Debye temperature parameters with that variable.
     recipe.create_new_variable("thetaD", 100)
-    recipe.constrain(recipe.lowT.thetaD, "thetaD")
-    recipe.constrain(recipe.highT.thetaD, "thetaD")
+    recipe.constrain_parameter(recipe.lowT.thetaD, "thetaD")
+    recipe.constrain_parameter(recipe.highT.thetaD, "thetaD")
     return recipe
 
 

docs/examples/npintensity.py

@@ -290,15 +290,15 @@ def gaussian(q, q0, width):
     lattice = phase.getLattice()
     a = lattice.a
     recipe.add_variable(a)
-    recipe.constrain(lattice.b, a)
-    recipe.constrain(lattice.c, a)
+    recipe.constrain_parameter(lattice.b, a)
+    recipe.constrain_parameter(lattice.c, a)
     # We want to refine the thermal parameters as well. We will add a new
     # Variable that we call "Uiso" and constrain the atomic Uiso values to
     # this. Note that we don't give Uiso an initial value. The initial value
     # will be inferred from the following constraints.
     Uiso = recipe.create_new_variable("Uiso")
     for atom in phase.getScatterers():
-        recipe.constrain(atom.Uiso, Uiso)
+        recipe.constrain_parameter(atom.Uiso, Uiso)
 
     # Give the recipe away so it can be used!
     return recipe

docs/examples/npintensityII.py

@@ -173,15 +173,15 @@ def gaussian(q, q0, width):
     a = recipe.add_variable(lattice.a)
     # We want to allow for isotropic expansion, so we'll make constraints for
     # that.
-    recipe.constrain(lattice.b, a)
-    recipe.constrain(lattice.c, a)
+    recipe.constrain_parameter(lattice.b, a)
+    recipe.constrain_parameter(lattice.c, a)
     # We want to refine the thermal parameters as well. We will add a new
     # variable that we call "Uiso" and constrain the atomic Uiso values to
     # this. Note that we don't give Uiso an initial value. The initial value
     # will be inferred from the subsequent constraints.
     Uiso = recipe.create_new_variable("Uiso")
     for atom in phase.getScatterers():
-        recipe.constrain(atom.Uiso, Uiso)
+        recipe.constrain_parameter(atom.Uiso, Uiso)
 
     # Give the recipe away so it can be used!
     return recipe

docs/examples/nppdfobjcryst.py

@@ -73,7 +73,7 @@ def makeRecipe(molecule, datname):
         # has no scattering power. It is only used as a reference point for
         # our bond length. We don't want to constrain it.
         if not atom.isDummy():
-            recipe.constrain(atom.Biso, Biso)
+            recipe.constrain_parameter(atom.Biso, Biso)
 
     # We need to let the molecule expand. If we were modeling it as a crystal,
     # we could let the unit cell expand. For instruction purposes, we use a
@@ -97,7 +97,7 @@ def makeRecipe(molecule, datname):
         # This creates a Parameter that moves the second atom according to the
         # bond length. Note that each Parameter needs a unique name.
         par = c60.addBondLengthParameter("rad%i" % i, center, atom)
-        recipe.constrain(par, radius)
+        recipe.constrain_parameter(par, radius)
 
     # Add the correlation term, scale. The scale is too short to effectively
     # determine qdamp.

docs/examples/nppdfsas.py

@@ -113,8 +113,8 @@ def makeRecipe(ciffile, grdata, iqdata):
     # Even though the cfcalculator and sasgenerator depend on the same sas
     # model, we must still constrain the cfcalculator Parameters so that it is
     # informed of changes in the refined parameters.
-    recipe.constrain(cfcalculator.radius_a, "radius_a")
-    recipe.constrain(cfcalculator.radius_b, "radius_b")
+    recipe.constrain_parameter(cfcalculator.radius_a, "radius_a")
+    recipe.constrain_parameter(cfcalculator.radius_b, "radius_b")
 
     return recipe
 
@@ -126,9 +126,9 @@ def fitRecipe(recipe):
     recipe.set_weight(recipe.pdf, 0)
     recipe.fix("all")
     recipe.free("radius_a", "radius_b", iqscale=1e8)
-    recipe.constrain("radius_b", "radius_a")
+    recipe.constrain_parameter("radius_b", "radius_a")
     scipyOptimize(recipe)
-    recipe.unconstrain("radius_b")
+    recipe.unconstrain_parameter("radius_b")
 
     # Tune PDF
     recipe.set_weight(recipe.pdf, 1)

docs/examples/simplepdftwophase.py

@@ -47,8 +47,8 @@ def makeRecipe(niciffile, siciffile, datname):
     # Start by configuring the scale factor and resolution factors.
     # We want the sum of the phase scale factors to be 1.
     recipe.create_new_variable("scale_ni", 0.1)
-    recipe.constrain(contribution.ni.scale, "scale_ni")
-    recipe.constrain(contribution.si.scale, "1 - scale_ni")
+    recipe.constrain_parameter(contribution.ni.scale, "scale_ni")
+    recipe.constrain_parameter(contribution.si.scale, "1 - scale_ni")
     # We also want the resolution factor to be the same on each. This is done
     # for free by the PDFContribution. We simply need to add it to the recipe.
     recipe.add_variable(contribution.qdamp, 0.03)