mgmg 1.5.0 → 1.5.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '0939daf2680e3d9a8a80a9616355ed10232ce6794b288ea86d295d283cfde413'
-  data.tar.gz: 7c6f9fdf112335d9844f1ec9e06c694b9cffd0a897787b4c9e74b306296b179c
+  metadata.gz: d7cadbd5fef7941e004310c08f8ec597ce06381b0b305369d0e42afa08cb5016
+  data.tar.gz: a0d9d53d2e0284274e4558c7d27f26aeb2af6eb2649faaa07d840a5cd4f5aed8
 SHA512:
-  metadata.gz: 31c5e140183a5417c833b7af756b454701333d71293bad1e5cd3f15073d71657c0503038daf0f7c7c02290aee22cef38c795ff98fc92df85462da96759c816f9
-  data.tar.gz: d02cfe4e1f571b76083c644cd0c44d41caced733e22d4c24853ac91b2a3410f53500c7867bda2b2109d46a873d4110a801d1cf2ecb7f2a3a54ba48f1d31d8b51
+  metadata.gz: fe3d521ee8e90ae3253dacf5389035a53e40d58d0a9e574c0685d346765fdef35de371412d772b77476809cf80a2bb384e1e0b20c0ada8c265f6155ad27fcf3a
+  data.tar.gz: 77638a9c41f22fa7a509f409645307d2a452822bd557aa83e5d0c8e96ac8e84c93f6d9fd3df265a04dc1e91abde3f143561f410c6b397a89fe599a0ee2dcc8f7

data/CHANGELOG.md

@@ -131,3 +131,10 @@
 	- 関連して，`String#max_weight`，`String#min_weight`，`Enumerable#max_weight`，`Enumerable#min_weight`，`Enumerable#max_weights`，`Enumerable#min_weights`を追加した．
 	- `Mgmg::Option#smith_min`，`Mgmg::Option#armor_min`のデフォルト値を，`String#min_level`，`Enumerable#min_level`を用いて設定する仕様とし，その目標重量を`Mgmg::Option#target_weight`で指定するようにした．
 - `String#min_comp`，`String#min_smith`，`Enumerable#min_comp`，`Enumerable#min_smith`において，既製品のみである，合成を行わないなど，該当スキルが必要ないレシピである場合の返り値を`-1`に変更した．
+
+## 1.5.1 2022/06/24
+- `Mgmg::Recipe`を実装し，レシピ`String`または`Enumerable`と，注目パラメータ`Symbol`，オプション`Mgmg::Option`をセットで取り扱えるようにした．
+	- `String#to_recipe(para=:power, allow_over20: false, **kw)`または`Enumerable#to_recipe(para=:power, **kw)`で生成できる．
+	- `Mgmg::Recipe#build`，`Mgmg::Recipe#search`など`String`等に対する操作と同様にでき，注目パラメータとオプションは，`to_recipe`でセットしたものがデフォルトで使われるようになる．各メソッド呼び出し時にキーワード引数を与えることで，一時的に上書きすることもできる．
+- `String#to_recipe`にのみ，☆20制限のチェック機構を導入した．
+- 計算を繰り返した際，複数装備の装備数が増加していってしまうバグを修正した．

data/README.md

@@ -54,6 +54,7 @@ puts r.build(122, 139, 232)
 ```
 
 製作品の重量及び特定の重量にするために必要な鍛冶・防具製作Lvを確認する．
+
 ```ruby
 r = 'サンダル(骨2皮1)+[重鎧(金3金3)+[フード(骨2宝1)+[重鎧(皮10金10)+軽鎧(鉄10皮1)]]]'
 p r.min_levels                 # 各材料装備を重量1で作るのに必要な防具製作Lv
@@ -61,7 +62,7 @@ p r.min_levels                 # 各材料装備を重量1で作るのに必要
 p r.min_levels(2)              # 同重量2以下
 #=> {"サンダル(骨2皮1)"=>3, "重鎧(金3金3)"=>102, "フード(骨2宝1)"=>3, "重鎧(皮10金10)"=>42, "軽鎧(鉄10皮1)"=>27}
 p [r.min_weight, r.max_weight] # 最小重量と最大重量
-#=> [5, 11]
+#=> [5, 10]
 p r.min_level                  # 最小重量で作るのに必要な防具製作Lv
 #=> 202
 p r.min_level(7)               # 重量7以下で作るのに必要な防具製作Lv
@@ -70,6 +71,20 @@ p r.min_level(-1)              # 最小重量+1=重量6以下で作るのに必
 #=> 162
 ```
 
+注目パラメータやオプションパラメータを，レシピ文字列とセットにして取り回す．
+```ruby
+r = '[[斧(鉄10皮1)+剣(牙10皮1)]+剣(鉄10皮1)]+剣(鉄10皮1)'
+r = r.to_recipe(:atkstr, target_weight: 5) # 注目パラメータを攻撃力+腕力，目標重量を5に設定
+p [r.min_level, r.min_level(0)]            # 必要な鍛冶Lvのデフォルトが目標重量ベースに
+#=> [72, 168]                              # 鍛冶Lv72で重量5(目標)に，鍛冶Lv168で重量4(最小)になる
+puts r.build(27, 42)                       # 変換前と同様に合成等もできる
+#=> 斧8☆20(鉄鉄)[攻撃:1,112, 腕力:18]     # 鍛冶Lv27だと重量8に
+p r.para_call(27, 42)                      # 注目パラメータのみを計算
+#=> 1130                                   # 1112+18=1130
+puts r.build(nil)                          # 目標重量を達成する最小製作Lvで製作
+#=> 斧5☆20(鉄鉄)[攻撃:1,436, 腕力:24]     # 製作Lvを nil にすると，目標重量のための最小製作Lv (72, 42) で製作
+```
+
 近似多項式を得る．
 
 ```ruby
@@ -97,22 +112,26 @@ p [sc, Mgmg.exp(*sc)]
 
 ```ruby
 r = '双短剣(金3皮1)+[杖(水1綿1)+[斧(玉5水1)+[杖(鉄1綿1)+[[斧(木2金3)+剣(鉄10皮1)]+[剣(木2綿1)+双短剣(鉄10皮1)]]]]]'
-sc = r.search(:atk_sd, 2000, opt: Mgmg.option(target_weight: 9))
+r = r.to_recipe(:atk_sd, target_weight: 9)
+sc = r.search(2000)    # to_recipe で注目パラメータを入れているので，ここでは不要
 p [sc, Mgmg.exp(*sc)]
-#=> [[70, 130], 38046]
-# オプションなしの場合は鍛冶Lv100以上を探索するため，[[100, 126], 41054] になる
+#=> [[70, 130], 38046] # オプションなしの場合は鍛冶Lv100以上を探索するため，[[100, 126], 41054] になる
 ```
 
 探索の際，スキル及び料理を考慮する．
 
 ```ruby
 r = '重鎧(皮2綿1)+[帽子(宝1宝1)+[重鎧(玉5金3)+[帽子(宝1宝1)+[重鎧(玉5金6)+[軽鎧(金3骨1)+[重鎧(皮2骨1)+軽鎧(鉄10綿1)]]]]]]'
-sc = r.search(:phydef, 100_000, opt: Mgmg.option(buff: %w|物防御UP アースドランと氷河酒の蒸し焼き ガードアップ|))
+r = r.to_recipe(:phydef, buff: %w|物防御UP アースドランと氷河酒の蒸し焼き ガードアップ|)
+sc = r.search(100_000)
 p [sc, Mgmg.exp(*sc)]
 #=> [[120, 264], 152502]
+puts r.build(*sc)           # 実際に作って確認
+#=> 重鎧8☆20(綿宝)[物防:100,396.0, 魔防:4]
+puts r.build(*sc, buff: []) # 一時的に強化を解除して素の性能を確認
+#=> 重鎧8☆20(綿宝)[物防:32,538, 魔防:4]
 ```
 
-
 各メソッドの詳しい説明等は [リファレンス](./reference.md) を参照されたい．
 
 ### 表記ゆれについて

data/lib/mgmg/equip.rb

@@ -13,7 +13,7 @@ module Mgmg
 		def initialize_copy(other)
 			@kind = other.kind
 			@weight = other.weight
-			@star = other.star
+			@star = other.star.dup
 			@main = other.main
 			@sub = other.sub
 			@para = other.para.dup
@@ -193,8 +193,8 @@ module Mgmg
 		def +(other)
 			self.dup.add!(other)
 		end
-		Zero = self.new(28, 0, Vec.new(6, 0), 12, 12, Vec.new(9, 0), Vec.new(3, 0))
-		Zero.history.clear
+		Zero = self.new(28, 0, Vec.new(6, 0).freeze, 12, 12, Vec.new(9, 0).freeze, Vec.new(3, 0).freeze)
+		Zero.total_cost.freeze; Zero.history.clear.freeze
 		Zero.freeze
 	end
 	

data/lib/mgmg/ir.rb

@@ -152,7 +152,7 @@ module Mgmg
 		attr_accessor :kind, :star, :main, :sub, :para, :rein
 		def initialize_copy(other)
 			@kind = other.kind
-			@star = other.star
+			@star = other.star.dup
 			@main = other.main
 			@sub = other.sub
 			@para = other.para.dup
@@ -313,7 +313,8 @@ module Mgmg
 		def +(other)
 			self.dup.add!(other)
 		end
-		Zero = self.new(28, Vec.new(6, 0), 12, 12, Array.new(9){Const.new(0)})
+		Zero = self.new(28, Vec.new(6, 0).freeze, 12, 12, Array.new(9){Const.new(0)}.freeze)
+		Zero.rein.freeze; Zero.freeze
 	end
 	class << IR
 		def build(str, left_associative: true, reinforcement: [])

data/lib/mgmg/option.rb

@@ -1,9 +1,4 @@
 module Mgmg
-	module_function def option(recipe=nil, **kw)
-		ret = Option.new(**kw)
-		ret.set_default(recipe) unless recipe.nil?
-		ret
-	end
 	class Option
 		def initialize(
 			left_associative: true,
@@ -50,7 +45,7 @@ module Mgmg
 			@irep = other.irep
 			@cut_exp = other.cut_exp
 		end
-		def set_default(recipe, force: false)
+		def update_sa_min(recipe, force=true)
 			case recipe
 			when String
 				if @smith_min.nil? && @armor_min
@@ -71,6 +66,10 @@ module Mgmg
 			else
 				raise ArgumentError, 'recipe should be String or Enumerable'
 			end
+			self
+		end
+		def set_default(recipe, force: false)
+			update_sa_min(recipe, force)
 			@comp_min = recipe.min_comp(opt: self) if force || @comp_min.nil?
 			@irep = recipe.ir(opt: self) if force || @irep.nil?
 			self

data/lib/mgmg/recipe.rb

@@ -0,0 +1,172 @@
+module Mgmg
+	class Recipe
+		def initialize(recipe, para=:power, **kw)
+			@recipe = recipe
+			@recipe.each(&:freeze) if @recipe.kind_of?(Enumerable)
+			@recipe.freeze
+			@para = para
+			@option = Option.new(**kw).set_default(@recipe)
+		end
+		attr_reader :recipe
+		attr_accessor :para
+		def initialize_copy(other)
+			@recipe = other.recipe.dup
+			@option = other.option.dup
+		end
+		private def temp_opt(**kw)
+			if kw.empty?
+				@option
+			else
+				ret = @option.dup
+				kw.each do |key, value|
+					ret.method((key.to_s+'=').to_sym).call(value)
+					ret.update_sa_min(@recipe) if key == :target_weight
+					ret.irep.add_reinforcement(value) if key == :reinforcement || key == :buff
+					if key == :left_associative
+						ret.irep = @recipe.ir(opt: ret).add_reinforcement(ret.reinforcement)
+					end
+				end
+				ret
+			end
+		end
+		def option(**kw)
+			@option = temp_opt(*kw)
+			@option
+		end
+		def option=(new_option)
+			@option = new_option.set_default(@recipe)
+		end
+		def replace(new_recipe, para: @para, **kw)
+			@recipe = new_recipe
+			@recipe.each(&:freeze) if @recipe.kind_of?(Enumerable)
+			@recipe.freeze
+			@para = para
+			@option = Option.new(**kw).set_default(@recipe)
+			self
+		end
+		def min_weight
+			@recipe.min_weight(opt: @option)
+		end
+		def max_weight(include_outsourcing=false)
+			@recipe.max_weight(opt: @option)
+		end
+		def min_level(w=@option.target_weight, include_outsourcing=false)
+			@recipe.min_level(w, include_outsourcing, opt: @option)
+		end
+		def min_levels(w=1)
+			@recipe.min_levels(w, opt: @option)
+		end
+		def min_levels_max(w=1)
+			@recipe.min_levels_max(w, opt: @option)
+		end
+		def min_smith
+			@recipe.min_smith
+		end
+		def min_comp
+			@recipe.min_comp
+		end
+		def build(smith=-1, armor=smith, comp=armor.tap{armor=smith}, **kw)
+			opt = temp_opt(**kw)
+			smith, armor, comp = opt.smith_min, opt.armor_min, opt.comp_min if smith.nil?
+			case @recipe
+			when String
+				recipe.build(smith, comp, opt: opt)
+			when Enumerable
+				recipe.build(smith, armor, comp, opt: opt)
+			else
+				raise BrokenRecipeError
+			end
+		end
+		def show(smith=-1, armor=smith, comp=armor.tap{armor=smith}, para: @para, **kw)
+			opt = temp_opt(**kw)
+			smith, armor, comp = opt.smith_min, opt.armor_min, opt.comp_min if smith.nil?
+			case @recipe
+			when String
+				recipe.show(smith, comp, para: para, opt: opt)
+			when Enumerable
+				recipe.show(smith, armor, comp, para: para, opt: opt)
+			else
+				raise BrokenRecipeError
+			end
+		end
+		def search(target, para: @para, **kw)
+			opt = temp_opt(**kw)
+			@recipe.search(para, target, opt: opt)
+		end
+		private def correct_level(s, ac, x, opt)
+			if s.nil?
+				if x.equal?(false)
+					s, ac, x = opt.smith_min, opt.comp_min, nil
+				else
+					s, ac, x = opt.smith_min, opt.armor_min, opt.comp_min
+				end
+			else
+				s = 0 if s < 0
+				ac = 0 if ac < 0
+				if x.equal?(false)
+					x = nil
+				else
+					x = 0 if x < 0
+				end
+			end
+			[s, ac, x]
+		end
+		def para_call(smith=-1, armor=smith, comp=armor.tap{armor=smith}, para: @para, **kw)
+			opt = temp_opt(**kw)
+			smith, armor, comp = correct_level(smith, armor, comp, opt)
+			case @recipe
+			when String
+				opt.irep.para_call(para, smith, comp)
+			when Enumerable
+				opt.irep.para_call(para, smith, armor, comp)
+			else
+				raise InvalidRecipeError
+			end
+		end
+		def ir(**kw)
+			temp_opt(**kw).irep
+		end
+		%i|attack phydef magdef hp mp str dex speed magic atkstr atk_sd dex_as mag_das magic2 magmag pmdef|.each do |sym|
+			define_method(sym) do |s, ac=s, x=false, **kw|
+				s, ac, x = correct_level(s, ac, x, temp_opt(**kw))
+				ir(**kw).method(sym).call(s, ac, x)
+			end
+		end
+		%i|power fpower|.each do |sym|
+			define_method(sym) do |s, a=s, c=a.tap{a=s}, **kw|
+				s, a, c = correct_level(s, a, c, temp_opt(**kw))
+				ir(**kw).method(sym).call(s, a, c)
+			end
+		end
+		%i|smith_cost comp_cost cost|.each do |sym|
+			define_method(sym) do |s, c=s, outsourcing=false, **kw|
+				s, c, x = correct_level(s, c, false, temp_opt(**kw))
+				ir(**kw).method(sym).call(s, c, out_sourcing)
+			end
+		end
+		def poly(para=@para, **kw)
+			opt = temp_opt(**kw)
+			if @recipe.kind_of?(String)
+				@recipe.poly(para, opt: opt)
+			else
+				raise InvalidRecipeError, "Mgmg::Recipe#poly is available only for String recipes."
+			end
+		end
+		def phydef_optimize(smith=nil, comp=smith, **kw)
+			opt = temp_opt(**kw)
+			if @recipe.kind_of?(String)
+				@recipe.phydef_optimize(smith, comp, opt: opt)
+			else
+				raise InvalidRecipeError, "Mgmg::Recipe#phydef_optimize is available only for String recipes."
+			end
+		end
+		def buster_optimize(smith=nil, comp=smith, **kw)
+			opt = temp_opt(**kw)
+			if @recipe.kind_of?(String)
+				@recipe.buster_optimize(smith, comp, opt: opt)
+			else
+				raise InvalidRecipeError, "Mgmg::Recipe#buster_optimize is available only for String recipes."
+			end
+		end
+	end
+end

data/lib/mgmg/search.rb

@@ -228,7 +228,18 @@ module Mgmg
 		if term <= start
 			raise ArgumentError, "start < term is needed, (start, term) = (#{start}, #{term}) are given"
 		end
-		opt_a, opt_b = opt_a.dup.set_default(a), opt_b.dup.set_default(b)
+		if a.kind_of?(Recipe)
+			opt_a = a.option.dup
+			a = a.recipe
+		else
+			opt_a = opt_a.dup.set_default(a)
+		end
+		if b.kind_of?(Recipe)
+			opt_b = b.option.dup
+			b = b.recipe
+		else
+			opt_b = opt_b.dup.set_default(b)
+		end
 		sca, scb = a.search(para, start, opt: opt_a), b.search(para, start, opt: opt_b)
 		ea, eb = Mgmg.exp(*sca), Mgmg.exp(*scb)
 		if eb < ea || ( ea == eb && opt_a.irep.para_call(para, *sca) < opt_b.irep.para_call(para, *scb) )
@@ -263,7 +274,18 @@ module Mgmg
 		if start <= term
 			raise ArgumentError, "term < start is needed, (start, term) = (#{start}, #{term}) are given"
 		end
-		opt_a, opt_b = opt_a.dup.set_default(a), opt_b.dup.set_default(b)
+		if a.kind_of?(Recipe)
+			opt_a = a.option.dup
+			a = a.recipe
+		else
+			opt_a = opt_a.dup.set_default(a)
+		end
+		if b.kind_of?(Recipe)
+			opt_b = b.option.dup
+			b = b.recipe
+		else
+			opt_b = opt_b.dup.set_default(b)
+		end
 		sca, scb = a.search(para, start, opt: opt_a), b.search(para, start, opt: opt_b)
 		ea, eb = Mgmg.exp(*sca), Mgmg.exp(*scb)
 		if ea < eb || ( ea == eb && opt_b.irep.para_call(para, *scb) < opt_a.irep.para_call(para, *sca) )

data/lib/mgmg/utils.rb

@@ -17,16 +17,33 @@ module Mgmg
 		refine Float do
 			alias :cdiv :quo # Floatの場合は普通の割り算
 			def comma3
-				s = self.to_s
-				case s
-				when %r|e|
-					s
-				when %r|\.|
-					ary = s.split('.')
-					ary[0].gsub(/(\d)(?=(\d{3})+(?!\d))/, '\1,') + '.' + ary[1]
+				s = (self*100).round.to_s
+				if s[0] == '-'
+					g, s = '-', s[1..(-1)]
 				else
-					s
+					g = ''
 				end
+				raise unless %r|\A\d+\Z|.match(s)
+				case s.length
+				when 1
+					if s == '0'
+						'0.0'
+					else
+						g+'0.0'+s
+					end
+				when 2
+					if s[1] == '0'
+						g+'0.'+s[0]
+					else
+						g+'0.'+s
+					end
+				else
+					i, d = s[0..(-3)], s[(-2)..(-1)]
+					d = d[0] if d[1] == '0'
+					g+i.gsub(/(\d)(?=(\d{3})+(?!\d))/, '\1,') + '.' + d
+				end
+			rescue
+				self.to_s
 			end
 		end
 		refine Rational do
@@ -78,6 +95,20 @@ module Mgmg
 		end
 		attr_accessor :name
 	end
+	class InvalidRecipeError < StandardError
+		def initialize(msg=nil)
+			if msg.nil?
+				super("Neither String nor Enumerable recipe was set.")
+			else
+				super(msg)
+			end
+		end
+	end
+	class Over20Error < StandardError
+		def initialize(star)
+			super("The star of given recipe is #{star}. It can't be built since the star is over 20.")
+		end
+	end
 	class SearchCutException < StandardError; end
 	class UnexpectedError < StandardError
 		def initialize()
@@ -122,6 +153,11 @@ module Mgmg
 	module_function def invexp3(exp, sa, comp)
 		Math.sqrt(exp - ((sa-1)**2) - (2*((comp-1)**2)) - 4).round + 1
 	end
+	module_function def option(recipe=nil, **kw)
+		ret = Option.new(**kw)
+		ret.set_default(recipe) unless recipe.nil?
+		ret
+	end
 	
 	CharacterList = /[^\(\)\+0123456789\[\]あきくしすたてなねのびりるイウガクグサジスタダチツデトドニノフブペボムラリルロンヴー一万二光兜典刀剣劣匠双古名吹咆品哮地大天太子安宝小帽弓弩当息悪戦手指斧書服木本杖業樹歴殺水氷法火炎牙物玉王産用界異的皮盾短石砕竜紫綿耳聖脛腕腿般良色衣袋覇質軍軽輝輪重量金鉄鎧闇陽靴額飾首骨鬼龍]/.freeze
 	module_function def check_string(str)

data/lib/mgmg/version.rb

@@ -1,3 +1,3 @@
 module Mgmg
-  VERSION = "1.5.0"
+  VERSION = "1.5.1"
 end

data/lib/mgmg.rb

@@ -8,10 +8,17 @@ require_relative './mgmg/system_equip'
 require_relative './mgmg/cuisine'
 require_relative './mgmg/reinforce'
 require_relative './mgmg/option'
+require_relative './mgmg/recipe'
 require_relative './mgmg/search'
 require_relative './mgmg/optimize'
 
 class String
+	using Mgmg::Refiner
+	def to_recipe(para=:power, allow_over20: false, **kw)
+		ret = Mgmg::Recipe.new(self, para, **kw)
+		raise Mgmg::Over20Error, ret.ir.star if (!allow_over20 and 20<ret.ir.star)
+		ret
+	end
 	def min_weight(opt: Mgmg::Option.new)
 		build(build(opt: opt).min_levels_max, opt: opt).weight
 	end
@@ -109,10 +116,10 @@ class String
 		built = build(smith, comp, opt: opt)
 		pstr = '%.3f' % built.para_call(para)
 		pstr.sub!(/\.?0+\Z/, '')
-		puts "Building"
+		puts "With levels (#{smith}, #{comp}: #{Mgmg.exp(smith, comp).comma3}), building"
 		puts "  #{self}"
-		rein = rein.empty? ? '' : " reinforced by {#{rein.join(',')}}"
-		puts "with levels (#{smith}, #{comp})#{rein} yields (#{pstr}, #{built.total_cost})"
+		rein = rein.empty? ? '' : "reinforced by {#{rein.join(',')}} "
+		puts "#{rein}yields (#{pstr}, #{built.total_cost})"
 		puts "  #{built}"
 	end
 	def phydef_optimize(smith=nil, comp=smith, opt: Mgmg::Option.new)
@@ -123,6 +130,10 @@ class String
 	end
 end
 module Enumerable
+	using Mgmg::Refiner
+	def to_recipe(para=:power, **kw)
+		Mgmg::Recipe.new(self, para, **kw)
+	end
 	def build(smith=-1, armor=smith, comp=armor.tap{armor=smith}, opt: Mgmg::Option.new)
 		opt = opt.dup
 		rein = opt.reinforcement
@@ -150,10 +161,10 @@ module Enumerable
 		built = self.build(smith, armor, comp, opt: opt)
 		pstr = '%.3f' % built.para_call(para)
 		pstr.sub!(/\.?0+\Z/, '')
-		puts "Building"
+		puts "With levels (#{smith}, #{armor}, #{comp}: #{Mgmg.exp(smith, armor, comp).comma3}), building"
 		puts "  #{self.join(', ')}"
-		rein = rein.empty? ? '' : " reinforced by {#{rein.join(',')}}"
-		puts "with levels (#{smith}, #{armor}, #{comp})#{rein} yields (#{pstr}, #{built.total_cost})"
+		rein = rein.empty? ? '' : "reinforced by {#{rein.join(',')}} "
+		puts "#{rein}yields (#{pstr}, #{built.total_cost})"
 		puts "  #{built}"
 	end
 	def min_weight(opt: Mgmg::Option.new)

data/reference.md

@@ -1,6 +1,11 @@
 # リファレンス
 本ライブラリで定義される主要なメソッドを以下に解説します．
 
+## `String#to_recipe(para=:power, allow_over20: false, **kw)`，`Enumerable#to_recipe(para=:power, **kw)`
+レシピ文字列である`self`と，注目パラメータ`para`，オプション`Mgmg.option(**kw)`をセットにした[後述](#mgmgrecipe)の`Mgmg::Recipe`オブジェクトを生成して返します．デフォルト値としてセットされたパラメータを使用する以外は，レシピ文字列と同様に扱えます．
+
+`allow_over20`が偽の場合，レシピの☆を確認し，20を超える場合は，例外`Mgmg::Over20Error`を発生します．このチェックを抑制したい場合は，真にしてください．
+
 ## `String#build(smith=-1, comp=smith, opt: Mgmg.option())`
 レシピ文字列である`self`を解釈し，鍛冶・防具製作Lvを`smith`，道具製作Lvを`comp`として鍛冶・防具製作及び武器・防具合成を行った結果を[後述](#mgmgequip)の`Mgmg::Equip`クラスのインスタンスとして生成し，返します．例えば，
 ```ruby
@@ -145,7 +150,8 @@
 返り値は`[逆転しない最大目標値, 逆転時の最小para値]`です．前者は逆転目標値の下限，後者は，目標値が前者よりも少しだけ大きいときの`para`値です．
 ここで，最小経験値が小さい方，または最小経験値が同じなら，そのときの`para`値が大きい方をよりよいものと解釈します．
 `term`は`start`より大きい値とします．目標値`term`における優劣が，目標値`start`における優劣と同じ場合，`Mgmg::SearchCutException`を発生します．
-`a`と`b`は`String`でもその`Enumerable`でも構いません．
+
+`a`と`b`は`String`でもその`Enumerable`でも構いません．`Mgmg::Recipe`が与えられた場合，`opt_a`，`opt_b`は無視され，代わりに`a.option`，`b.option`が使用されます．`a.para`，`b.para`は無視され，引数で与えた`para`を使用します．
 
 `opt_a`，`opt_b`には，それぞれ`a`と`b`に関するオプションパラメータを指定します．`smith_min`，`armor_min`，`min_smith`，`left_associative`，`reinforcement`，`irep`を使用します．
 
@@ -451,3 +457,55 @@ alias として`*`があるほか`scalar(1.quo(value))`として`quo`，`/`，`s
 |irep|`recipe.ir()`|`Mgmg::IR`の使い回しによる高速化|`String#search`など，内部的に使用|
 |cut_exp|`Float::INFINITY`|探索時の総経験値の打ち切り値|`String#search`など，内部的に使用|
 
+## `Mgmg::Recipe`
+レシピ文字列，注目パラメータ，オプションをセットにして扱うためのクラスです．
+それぞれ`Mgmg::Recipe#recipe`，`Mgmg::Recipe#para`，`Mgmg::Recipe#option`でアクセスできます．
+
+## `Mgmg::Recipe#option(**kw)`
+オプションパラメータを`kw`で上書きして，新しい`Mgmg::Option`インスタンスを返します．
+渡したバラメータだけ上書きします．パラメータを渡さない場合，単にセットになってるオプションオブジェクトを返します．
+`target_weight`を上書きした場合，`smith_min`，`armor_min`は自動的に再計算されます．
+
+与えるパラメータ以外をデフォルト値に戻したい場合，`recipe.option=Mgmg.option(**kw)`のように`Mgmg::Recipe#option=(new_option)`を使用します．
+
+## `Mgmg::Recipe#replace(new_recipe, para: self.para, **kw)`
+レシピ文字列を`new_recipe`で置き換え，`kw`でオプションを設定します．`para`を与えた場合，注目パラメータも引数で置き換えます．
+レシピ文字列とオプションの対応を保つため，`Mgmg::Recipe#recipe=`メソッドは定義していません．代わりにこれを使います．
+
+## `Mgmg::Recipe#build(smith=-1, armor=smith, comp=armor.tap{armor=smith}, **kw)`
+`self.recipe.build`を呼び出して返します．`kw`が与えられた場合，オプションのうち，与えられたパラメータのみ一時的に上書きします．
+
+`smith`に`nil`を与えた場合，製作Lvを`self.option.smith_min`，`self.option.armor_min`，`self.option.comp_min`とします．
+
+## `Mgmg::Recipe#search(target, para: self.para, **kw)`
+`self.recipe.search`を呼び出して返します．注目パラメータはセットされたものを自動的に渡しますが，別のパラメータを使いたい場合，キーワード引数で指定します．その他のキーワード引数を与えた場合，オプションのうち，与えられたパラメータのみ一時的に上書きします．
+
+## `Mgmg::Recipe#min_level(w=self.option.target_weight, include_outsourcing=false)`
+`self.recipe.min_level(w, include_outsourcing)`を返します．`w`のデフォルトパラメータが`target_weight`になっている以外は`String#min_level`または`Enumerable#min_level`と同じです．
+
+## `Mgmg::Recipe#min_weight, max_weight, min_levels, min_levels_max, min_smith, min_comp`
+`self.recipe`の同名メソッドをそのまま呼び出して返します．
+
+## `Mgmg::Recipe#ir(**kw)`
+`self.recipe`に対応した`Mgmg::IR`インスタンスを返します．
+
+`kw`を与えた場合一時的に置き換えたオプションに対応した`Mgmg::IR`インスタンスを返します．`left_associative`が与えられれば再構築し，`reinforcement`が与えられれば，スキル・料理の効果を与えた引数に差し替えます．その他のキーワードを与えても特に影響はありません．
+
+## `Mgmg::Recipe#para_call(smith=-1, armor=smith, comp=armor.tap{armor=smith}, para: self.para, **kw)`
+`self.ir.para_call`を呼び出して返します．キーワード引数が与えられた場合，与えられた分だけ一時的に上書きします．
+
+`smith`に`nil`を与えた場合，製作Lvを`self.option.smith_min`，`self.option.armor_min`，`self.option.comp_min`とします．製作Lvに負の値が与えられた場合，`0`に修正して計算して返します．
+
+パラメータとして，以下が指定でき，これらは直接メソッドとしても定義されています(`Mgmg::Recipe#attack`など)．製作Lvの与え方は`para_call`と同様です．
+
+```ruby
+:attack, :phydef, :magdef, :hp, :mp, :str, :dex, :speed, :magic
+:atkstr, :atk_sd, :dex_as, :mag_das, :magic2, :magmag, :pmdef
+:power, :fpower, :smith_cost, :comp_cost, :cost
+```
+
+## `Mgmg::Recipe#poly(para=self.para, **kw)`
+`self.recipe.poly(para, opt: self.option)`を返します．`kw`が与えられた場合，オプションのうち，与えられたパラメータのみ一時的に上書きします．
+
+## `Mgmg::Recipe#phydef_optimize(smith=nil, comp=smith, **kw)`，`Mgmg::Recipe#buster_optimize(smith=nil, comp=smith, **kw)`
+`self.recipe.phydef_optimize(smith, comp, opt: self.option)`，`self.recipe.buster_optimize(smith, comp, opt: self.option)`を返します．`kw`が与えられた場合，オプションのうち，与えられたパラメータのみ一時的に上書きします．

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: mgmg
 version: !ruby/object:Gem::Version
-  version: 1.5.0
+  version: 1.5.1
 platform: ruby
 authors:
 - KAZOON
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2022-06-22 00:00:00.000000000 Z
+date: 2022-06-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -75,6 +75,7 @@ files:
 - lib/mgmg/optimize.rb
 - lib/mgmg/option.rb
 - lib/mgmg/poly.rb
+- lib/mgmg/recipe.rb
 - lib/mgmg/reinforce.rb
 - lib/mgmg/search.rb
 - lib/mgmg/system_equip.rb