• Top
    • Documentation
    • Books
    • Recursion-and-induction
    • Boolean-reasoning
      • Ipasir
      • Aignet
      • Aig
      • Satlink
      • Truth
        • Index-permute-shrink
        • Permute-stretch
          • Env-mismatch-aux
          • Permute-shrink
          • Permute-polarity
          • Env-permute-polarity
          • Env-permute-shrink
          • Permute-var-down
          • Swap-vars-aux
          • Env-permute-stretch
          • Swap-vars
          • Permute-var-up
          • Negative-cofactor
          • Truth-perm-rev
          • Index-permute-stretch
          • Env-mismatch
          • Truth-perm
          • Swap-polarity
          • Positive-cofactor
          • Index-perm-rev
          • Env-perm-rev
          • Nth-set-bit-pos
          • Index-swap
          • Env-move-var-down
          • Is-xor-with-var
          • Index-perm
          • Env-swap-vars
          • Var
          • Truth-eval
          • Index-move-down
          • Env-update
          • Env-perm
          • Depends-on-witness
          • Env-swap-polarity
          • Var-repetitions
          • Env-move-var-up
          • Index-move-up
          • Depends-on
          • Truth-norm
          • Index-listp
          • Env-diff-index
          • Env-lookup
          • True
          • False
        • Ubdds
        • Bdd
        • Faig
        • Bed
        • 4v
      • Projects
      • Debugging
      • Std
      • Proof-automation
      • Macro-libraries
      • ACL2
      • Interfacing-tools
      • Hardware-verification
      • Software-verification
      • Testing-utilities
      • Math
    • Truth

    Permute-stretch

    Signature
    (permute-stretch n count mask truth numvars) → perm-truth
    Arguments
    n — Guard (natp n).
    mask — Guard (natp mask).
    truth — Guard (integerp truth).
    numvars — Guard (natp numvars).
    Returns
    perm-truth — Type (natp perm-truth).

    Definitions and Theorems

    Function: permute-stretch

    (defun
      permute-stretch
      (n count mask truth numvars)
      (declare (xargs :guard (and (natp n)
                                  (natp mask)
                                  (integerp truth)
                                  (natp numvars))))
      (declare
           (xargs :guard (and (<= n numvars)
                              (eql count (logcount (loghead n mask))))))
      (let ((__function__ 'permute-stretch))
           (declare (ignorable __function__))
           (b* (((when (mbe :logic (zp (- (nfix numvars) (nfix n)))
                            :exec (eql n numvars)))
                 (truth-norm truth numvars))
                (n (lnfix n))
                (count (mbe :logic (logcount (loghead n (lnfix mask)))
                            :exec count))
                (bit (logbit n (lnfix mask)))
                (truth (permute-stretch (1+ n)
                                        (+ bit count)
                                        mask truth numvars)))
               (if (eql bit 1)
                   (permute-var-up count n truth numvars)
                   truth))))

    Theorem: natp-of-permute-stretch

    (defthm
         natp-of-permute-stretch
         (b* ((perm-truth (permute-stretch n count mask truth numvars)))
             (natp perm-truth))
         :rule-classes :type-prescription)

    Theorem: normalize-count-of-permute-stretch

    (defthm
     normalize-count-of-permute-stretch
     (b*
      nil
      (implies
           (syntaxp (not (equal count ''nil)))
           (equal (permute-stretch n count mask truth numvars)
                  (let ((count nil))
                       (permute-stretch n count mask truth numvars))))))

    Theorem: eval-of-permute-stretch-with-env-permute-stretch

    (defthm
     eval-of-permute-stretch-with-env-permute-stretch
     (b*
      ((?perm-truth (permute-stretch n count mask truth numvars)))
      (implies
       (<= (nfix n) (nfix numvars))
       (equal (truth-eval perm-truth
                          (env-permute-stretch n count mask env numvars)
                          numvars)
              (truth-eval truth env numvars)))))

    Theorem: eval-of-permute-stretch

    (defthm
     eval-of-permute-stretch
     (b*
      ((?perm-truth (permute-stretch n count mask truth numvars)))
      (implies
        (<= (nfix n) (nfix numvars))
        (equal (truth-eval perm-truth env numvars)
               (truth-eval truth
                           (env-permute-shrink n count mask env numvars)
                           numvars)))))

    Theorem: size-of-permute-stretch

    (defthm
        size-of-permute-stretch
        (b* ((?perm-truth (permute-stretch n count mask truth numvars)))
            (implies (and (natp size)
                          (<= (ash 1 (nfix numvars)) size))
                     (unsigned-byte-p size perm-truth))))

    Theorem: depends-on-of-permute-stretch

    (defthm
     depends-on-of-permute-stretch
     (implies
       (and (natp numvars)
            (< (nfix n) numvars)
            (not (depends-on (index-permute-shrink 0 nil mask n numvars)
                             truth numvars)))
       (not (depends-on n
                        (permute-stretch 0 count mask truth numvars)
                        numvars))))

    Theorem: permute-stretch-of-truth-norm

    (defthm
         permute-stretch-of-truth-norm
         (equal (permute-stretch n count mask (truth-norm truth numvars)
                                 numvars)
                (permute-stretch n count mask truth numvars)))

    Theorem: permute-stretch-of-nfix-n

    (defthm permute-stretch-of-nfix-n
            (equal (permute-stretch (nfix n)
                                    count mask truth numvars)
                   (permute-stretch n count mask truth numvars)))

    Theorem: permute-stretch-nat-equiv-congruence-on-n

    (defthm
        permute-stretch-nat-equiv-congruence-on-n
        (implies
             (nat-equiv n n-equiv)
             (equal (permute-stretch n count mask truth numvars)
                    (permute-stretch n-equiv count mask truth numvars)))
        :rule-classes :congruence)

    Theorem: permute-stretch-of-nfix-mask

    (defthm permute-stretch-of-nfix-mask
            (equal (permute-stretch n count (nfix mask)
                                    truth numvars)
                   (permute-stretch n count mask truth numvars)))

    Theorem: permute-stretch-nat-equiv-congruence-on-mask

    (defthm
        permute-stretch-nat-equiv-congruence-on-mask
        (implies
             (nat-equiv mask mask-equiv)
             (equal (permute-stretch n count mask truth numvars)
                    (permute-stretch n count mask-equiv truth numvars)))
        :rule-classes :congruence)

    Theorem: permute-stretch-of-ifix-truth

    (defthm permute-stretch-of-ifix-truth
            (equal (permute-stretch n count mask (ifix truth)
                                    numvars)
                   (permute-stretch n count mask truth numvars)))

    Theorem: permute-stretch-int-equiv-congruence-on-truth

    (defthm
        permute-stretch-int-equiv-congruence-on-truth
        (implies
             (int-equiv truth truth-equiv)
             (equal (permute-stretch n count mask truth numvars)
                    (permute-stretch n count mask truth-equiv numvars)))
        :rule-classes :congruence)

    Theorem: permute-stretch-of-nfix-numvars

    (defthm permute-stretch-of-nfix-numvars
            (equal (permute-stretch n count mask truth (nfix numvars))
                   (permute-stretch n count mask truth numvars)))

    Theorem: permute-stretch-nat-equiv-congruence-on-numvars

    (defthm
        permute-stretch-nat-equiv-congruence-on-numvars
        (implies
             (nat-equiv numvars numvars-equiv)
             (equal (permute-stretch n count mask truth numvars)
                    (permute-stretch n count mask truth numvars-equiv)))
        :rule-classes :congruence)