===============================================================
Section Copy Tool - Distributed Mechanisms & L, nseg, Ra
Version: 1.0, Release Date: 03/07/2014
Developed by: Shailesh Appukuttan, IIT Bombay
Email: appukuttan.shailesh@gmail.com
===============================================================

Usage:

- Copy 'sectionCopy.hoc' to your folder containing the model
  files. Load the file by:
load_file("sectionCopy.hoc")
- Call the procedure 'copySec()' as explained below

Syntax to call function:
copySec(A, B, y, z)

>> Copies biophysical data (Distributed Mechanisms & L, nseg, Ra) from
   section A to all sections in B
A : SectionRef
B : SectionList
y : 0 = Add new mechanisms, update common mechanisms and RETAIN other
    existing mechanisms
  : 1 = Add new mechanisms, update common mechanisms and REMOVE other
    existing mechanisms
z : 0 = Copy L, nseg and Ra as well
  : 1 = Do not copy L, nseg and Ra

Example:
The included file 'cell.hoc' provides a basic example of using this
tool.

 
Note about 'y': 
-------------------
>> When y = 0
- If any section in B had distributed mechanisms prior to calling
  copySec(A, B, 0, z), then after the function is invoked B shall
  continue to have them in addition to the new ones obtained from A;
  the common ones would have their parameters updated based on
  A. Example:

BEFORE copySec(A, B, 0, z)
A (pas, extracellular)
B (hh, extracellular)

AFTER copySec(A, B, 0, z)
A (pas, extracellular)
B (hh, pas, extracellular) - with parameters of extracellular copied from A

>> When y = 1
- If any section in B had distributed mechanisms prior to calling
  copySec(A, B, 1, z), then after the function is invoked B will only
  have the new mechanisms obtained from A and the common ones with
  their parameters copied from A. The mechanisms it had previously
  (absent in A) would be removed. Example:

BEFORE copySec(A, B, 1, z)
A (pas, extracellular)
B (hh, extracellular)

AFTER copySec(A, B, 1, z)
A (pas, extracellular)
B (pas, extracellular) - with parameters of extracellular copied from A

  
Note about 'z':
-------------------

- L, nseg and Ra are neither distributed mechanisms nor point
  processes and hence need to be treated separately by means of this
  parameter 'z'.
- User should be careful of implications arising out of copying data
  between sections having different number of segments (setting z =
  1).
- For more info: Read sections 5.4.4 and 5.6 from The NEURON Book :)
- Might be wise to manually verify sections after copying.


* Disclaimer :)
-------------------
Not responsible for direct, indirect, incidental or consequential
damages resulting from any error or failure to perform.