Changeset 8138


Ignore:
Timestamp:
Mar 10, 2011, 8:33:27 PM (14 years ago)
Author:
wilsonr
Message:

Removed all the '@brief' commenting.

File:
1 edited

Legend:

Unmodified
Added
Removed
  • trunk/anuga_core/source/anuga/shallow_water/forcing.py

    r8125 r8138  
    156156
    157157        self.const = eta_w*rho_a/rho_w
    158     ##
    159     # @brief 'execute' this class instance.
    160     # @param domain
     158
    161159    def __call__(self, domain):
    162160        """Evaluate windfield based on values found in domain"""
     
    205203
    206204
    207 ##
    208 # @brief Assign wind field values
    209 # @param xmom_update
    210 # @param ymom_update
    211 # @param s_vec
    212 # @param phi_vec
    213 # @param const
    214205def assign_windfield_values(xmom_update, ymom_update,
    215206                            s_vec, phi_vec, const):
     
    237228
    238229
    239 ##
    240 # @brief A class for a general explicit forcing term.
    241230class General_forcing:
    242231    """General explicit forcing term for update of quantity
     
    275264    # FIXME (AnyOne) : Add various methods to allow spatial variations
    276265
    277     ##
    278     # @brief Create an instance of this forcing term.
    279     # @param domain
    280     # @param quantity_name
    281     # @param rate
    282     # @param center
    283     # @param radius
    284     # @param polygon
    285     # @param default_rate
    286     # @param verbose
    287266    def __init__(self,
    288267                 domain,
     
    425404        self.default_rate_invoked = False    # Flag
    426405
    427     ##
    428     # @brief Execute this instance.
    429     # @param domain
    430406    def __call__(self, domain):
    431407        """Apply inflow function at time specified in domain, update stage"""
     
    477453                self.update[k] += rate
    478454
    479     ##
    480     # @brief Update the internal rate.
    481     # @param t A callable or scalar used to set the rate.
    482     # @return The new rate.
    483455    def update_rate(self, t):
    484456        """Virtual method allowing local modifications by writing an
     
    493465        return rate
    494466
    495     ##
    496     # @brief Get values for the specified quantity.
    497     # @param quantity_name Name of the quantity of interest.
    498     # @return The value(s) of the quantity.
    499     # @note If 'quantity_name' is None, use self.quantity_name.
    500467    def get_quantity_values(self, quantity_name=None):
    501468        """Return values for specified quantity restricted to opening
     
    512479                            indices=self.exchange_indices)
    513480
    514     ##
    515     # @brief Set value for the specified quantity.
    516     # @param val The value object used to set value.
    517     # @param quantity_name Name of the quantity of interest.
    518     # @note If 'quantity_name' is None, use self.quantity_name.
    519481    def set_quantity_values(self, val, quantity_name=None):
    520482        """Set values for specified quantity restricted to opening
     
    536498
    537499        return false
    538 ##
    539 # @brief A class for rainfall forcing function.
    540 # @note Inherits from General_forcing.
     500
    541501class Rainfall(General_forcing):
    542502    """Class Rainfall - general 'rain over entire domain' forcing term.
     
    584544    """
    585545
    586     ##
    587     # @brief Create an instance of the class.
    588     # @param domain Domain of interest.
    589     # @param rate Total rain rate over the specified domain (mm/s).
    590     # @param center
    591     # @param radius
    592     # @param polygon Polygon  to restrict rainfall.
    593     # @param default_rate
    594     # @param verbose True if this instance is to be verbose.
    595546    def __init__(self,
    596547                 domain,
     
    629580
    630581
    631 ##
    632 # @brief A class for inflow (rain and drain) forcing function.
    633 # @note Inherits from General_forcing.
    634582class Inflow(General_forcing):
    635583    """Class Inflow - general 'rain and drain' forcing term.
     
    680628    """
    681629
    682     ##
    683     # @brief Create an instance of the class.
    684     # @param domain Domain of interest.
    685     # @param rate Total rain rate over the specified domain (mm/s).
    686     # @param center
    687     # @param radius
    688     # @param polygon Polygon  to restrict rainfall.
    689     # @param default_rate
    690     # @param verbose True if this instance is to be verbose.
    691630    def __init__(self,
    692631                 domain,
     
    697636                 default_rate=None,
    698637                 verbose=False):
     638        """Create an instance of the class
     639
     640        domain        Domain of interest
     641        rate          Total rain rate over the specified domain (mm/s)
     642        center
     643        radius
     644        polygon       Polygon to restrict rainfall
     645        default_rate
     646        verbose       True if this instance is to be verbose
     647        """
     648
    699649        # Create object first to make area is available
    700650        General_forcing.__init__(self,
     
    708658                                 verbose=verbose)
    709659
    710     ##
    711     # @brief Update the instance rate.
    712     # @param t New rate object.
    713660    def update_rate(self, t):
    714661        """Virtual method allowing local modifications by writing an
    715662        overriding version in descendant
    716663
     664        t  New rate object
     665
    717666        This one converts m^3/s to m/s which can be added directly
    718667        to 'stage' in ANUGA
     
    727676
    728677
    729 ##
    730 # @brief A class for creating cross sections.
    731 # @note Inherits from General_forcing.
    732678class Cross_section:
    733679    """Class Cross_section - a class to setup a cross section from
    734680    which you can then calculate flow and energy through cross section
    735 
    736681
    737682    Cross_section(domain, polyline)
     
    745690    """
    746691
    747     ##
    748     # @brief Create an instance of the class.
    749     # @param domain Domain of interest.
    750     # @param polyline Polyline defining cross section
    751     # @param verbose True if this instance is to be verbose.
    752692    def __init__(self,
    753693                 domain,
    754694                 polyline=None,
    755695                 verbose=False):
     696        """Create an instance of Cross_section.
     697
     698        domain    domain of interest
     699        polyline  polyline defining cross section
     700        verbose   True if this instance is to be verbose
     701        """
    756702       
    757703        self.domain = domain
     
    770716        self.midpoints = ensure_geospatial(self.midpoints, self.domain.geo_reference)
    771717
    772     ##
    773     # @brief set verbose mode
    774718    def set_verbose(self,verbose=True):
    775         """Set verbose mode true or flase
    776         """
     719        """Set verbose mode true or flase"""
    777720
    778721        self.verbose=verbose
    779722
    780     ##
    781     # @brief calculate current flow through cross section
    782723    def get_flow_through_cross_section(self):
    783724        """ Output: Total flow [m^3/s] across cross section.
     
    809750 
    810751
    811     ##
    812     # @brief calculate current energy flow through cross section
    813752    def get_energy_through_cross_section(self, kind='total'):
    814753        """Obtain average energy head [m] across specified cross section.
     
    954893            self.pressure = p
    955894
    956     ##
    957     # @brief 'execute' this class instance.
    958     # @param domain
    959895    def __call__(self, domain):
    960896        """Evaluate pressure field based on values found in domain"""
     
    994930
    995931
    996 ##
    997 # @brief Assign pressure field values
    998 # @param xmom_update
    999 # @param ymom_update
    1000 # @param s_vec
    1001 # @param phi_vec
    1002 # @param const
    1003932def assign_pressure_field_values(height, pressure, x, triangles,
    1004933                                 xmom_update, ymom_update):
     
    11601089
    11611090
    1162     ##
    1163     # @brief 'execute' this class instance.
    1164     # @param domain
    11651091    def __call__(self, domain):
    11661092        """Evaluate pressure field based on values found in domain"""
     
    13451271
    13461272        self.const = eta_w*rho_a/rho_w
    1347     ##
    1348     # @brief 'execute' this class instance.
    1349     # @param domain
     1273
    13501274    def __call__(self, domain):
    13511275        """Evaluate windfield based on values found in domain"""
Note: See TracChangeset for help on using the changeset viewer.