IMP logo
IMP Reference Guide  2.5.0
The Integrative Modeling Platform
IMP.test.TestCase Class Reference

Super class for IMP test cases. More...

+ Inheritance diagram for IMP.test.TestCase:

Detailed Description

Super class for IMP test cases.

Note
This class is only available in Python.

Definition at line 484 of file test/__init__.py.

Public Member Functions

def assertClassNames
 Check that all the classes in the module follow the imp naming conventions. More...
 
def assertFunctionNames
 Check that all the functions in the module follow the IMP naming conventions. More...
 
def assertRaisesUsageException
 Assert that the given callable object raises UsageException. More...
 
def assertShow
 Check that all the classes in modulename have a show method. More...
 
def assertValueObjects
 Check that all the C++ classes in the module are values or objects. More...
 
def assertXYZDerivativesInTolerance
 Assert that x,y,z analytical derivatives match numerical within a tolerance, or a percentage (of the analytical value), whichever is larger. More...
 
def check_get_from
 Check that the get_from() static method works correctly. More...
 
def check_runnable_python_module
 Check a Python module designed to be runnable with 'python -m' to make sure it supports standard command line options. More...
 
def check_unary_function_deriv
 Check the unary function func's derivatives against numerical approximations between lb and ub. More...
 
def check_unary_function_min
 Make sure that the minimum of the unary function func over the range between lb and ub is at expected_fmin. More...
 
def create_particles_in_box
 Create a bunch of particles in a box. More...
 
def create_point_particle
 Make a particle with optimizable x, y and z attributes, and add it to the model. More...
 
def failure_probability
 Estimate how likely a given block of code is to raise an AssertionError. More...
 
def get_input_file_name
 Get the full name of an input file in the top-level test directory. More...
 
def get_tmp_file_name
 Get the full name of an output file in the tmp directory. More...
 
def open_input_file
 Open and return an input file in the top-level test directory. More...
 
def particle_distance
 Return distance between two given particles. More...
 
def probabilistic_test
 Help handle a test which is expected to fail some fraction of the time. More...
 
def randomize_particles
 Randomize the xyz coordinates of a list of particles. More...
 
def run_example
 Run the named example script. More...
 
def run_python_module
 Run a Python module as if with "python -m <modname>", with the given list of arguments as sys.argv. More...
 

Member Function Documentation

def IMP.test.TestCase.assertClassNames (   self,
  module,
  exceptions,
  words 
)

Check that all the classes in the module follow the imp naming conventions.

Definition at line 711 of file test/__init__.py.

def IMP.test.TestCase.assertFunctionNames (   self,
  module,
  exceptions,
  words 
)

Check that all the functions in the module follow the IMP naming conventions.

Definition at line 812 of file test/__init__.py.

def IMP.test.TestCase.assertRaisesUsageException (   self,
  c,
  args,
  keys 
)

Assert that the given callable object raises UsageException.

This differs from unittest's assertRaises in that the test is skipped in fast mode (where usage checks are turned off).

Definition at line 531 of file test/__init__.py.

def IMP.test.TestCase.assertShow (   self,
  modulename,
  exceptions 
)

Check that all the classes in modulename have a show method.

Definition at line 833 of file test/__init__.py.

def IMP.test.TestCase.assertValueObjects (   self,
  module,
  exceptions_list 
)

Check that all the C++ classes in the module are values or objects.

Definition at line 659 of file test/__init__.py.

def IMP.test.TestCase.assertXYZDerivativesInTolerance (   self,
  sf,
  xyz,
  tolerance = 0,
  percentage = 0 
)

Assert that x,y,z analytical derivatives match numerical within a tolerance, or a percentage (of the analytical value), whichever is larger.

sf should be a ScoringFunction or Restraint, although for backwards compatibility a Model is also accepted.

Definition at line 538 of file test/__init__.py.

def IMP.test.TestCase.check_get_from (   self,
  obj 
)

Check that the get_from() static method works correctly.

Definition at line 638 of file test/__init__.py.

def IMP.test.TestCase.check_runnable_python_module (   self,
  module 
)

Check a Python module designed to be runnable with 'python -m' to make sure it supports standard command line options.

Definition at line 925 of file test/__init__.py.

def IMP.test.TestCase.check_unary_function_deriv (   self,
  func,
  lb,
  ub,
  step 
)

Check the unary function func's derivatives against numerical approximations between lb and ub.

Definition at line 620 of file test/__init__.py.

def IMP.test.TestCase.check_unary_function_min (   self,
  func,
  lb,
  ub,
  step,
  expected_fmin 
)

Make sure that the minimum of the unary function func over the range between lb and ub is at expected_fmin.

Definition at line 628 of file test/__init__.py.

def IMP.test.TestCase.create_particles_in_box (   self,
  model,
  num = 10,
  lb = [0,
  ub = [10 
)

Create a bunch of particles in a box.

Definition at line 644 of file test/__init__.py.

def IMP.test.TestCase.create_point_particle (   self,
  model,
  x,
  y,
  z 
)

Make a particle with optimizable x, y and z attributes, and add it to the model.

Definition at line 558 of file test/__init__.py.

def IMP.test.TestCase.failure_probability (   self,
  testcall 
)

Estimate how likely a given block of code is to raise an AssertionError.

Definition at line 586 of file test/__init__.py.

def IMP.test.TestCase.get_input_file_name (   self,
  filename 
)

Get the full name of an input file in the top-level test directory.

Definition at line 503 of file test/__init__.py.

def IMP.test.TestCase.get_tmp_file_name (   self,
  filename 
)

Get the full name of an output file in the tmp directory.

Definition at line 521 of file test/__init__.py.

def IMP.test.TestCase.open_input_file (   self,
  filename,
  mode = 'rb' 
)

Open and return an input file in the top-level test directory.

Definition at line 517 of file test/__init__.py.

def IMP.test.TestCase.particle_distance (   self,
  p1,
  p2 
)

Return distance between two given particles.

Definition at line 610 of file test/__init__.py.

def IMP.test.TestCase.probabilistic_test (   self,
  testcall,
  chance_of_failure 
)

Help handle a test which is expected to fail some fraction of the time.

The test is run multiple times and an exception is thrown only if it fails too many times.

Definition at line 567 of file test/__init__.py.

def IMP.test.TestCase.randomize_particles (   self,
  particles,
  deviation 
)

Randomize the xyz coordinates of a list of particles.

Definition at line 599 of file test/__init__.py.

def IMP.test.TestCase.run_example (   self,
  filename 
)

Run the named example script.

A dictionary of all the script's global variables is returned. This can be queried in a test case to make sure the example performed correctly.

Definition at line 863 of file test/__init__.py.

def IMP.test.TestCase.run_python_module (   self,
  module,
  args 
)

Run a Python module as if with "python -m <modname>", with the given list of arguments as sys.argv.

If module is an already-imported Python module, run its 'main' function and return the result.

If module is a string, run the module in a subprocess and return a subprocess.Popen-like object containing the child stdin, stdout and stderr.

Definition at line 894 of file test/__init__.py.


The documentation for this class was generated from the following file: