• Top
    • Documentation
    • Books
    • Boolean-reasoning
      • Ipasir
      • Aignet
      • Aig
      • Satlink
      • Truth
        • Index-permute-shrink
        • Permute-stretch
          • Permute-shrink
          • Env-mismatch-aux
          • Env-permute-shrink
          • Permute-polarity
          • Env-permute-polarity
          • Permute-var-down
          • Env-permute-stretch
          • Swap-vars-aux
          • Swap-vars
          • Permute-var-up
          • Truth-perm-rev
          • Negative-cofactor
          • Index-permute-stretch
          • Env-mismatch
          • Swap-polarity
          • Positive-cofactor
          • Truth-perm
          • Index-perm-rev
          • Nth-set-bit-pos
          • Env-perm-rev
          • Is-xor-with-var
          • Index-swap
          • Index-perm
          • Env-move-var-down
          • Truth-eval
          • Env-swap-vars
          • Env-perm
          • Depends-on-witness
          • Var
          • Index-move-down
          • Env-update
          • Env-swap-polarity
          • Var-repetitions
          • Env-move-var-up
          • Depends-on
          • Index-move-up
          • 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
      • Math
      • Testing-utilities
    • 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)